Desarrollar en VTEX IO - AnselmiKudos/test GitHub Wiki

:pushpin: Tabla de contenido

Getting started

Cualquier desarrollo en VTEX IO comienza con Toolbelt , nuestra CLI (interfaz de línea de comando) que le permite iniciar sesión, desarrollar nuevas aplicaciones y administrar las ya instaladas.

VTEX Toolbelt se puede instalar a través de npm. Si no lo tiene instalado, puede incluirlo con node:

Instalación de VTEX Toolbelt

Se recomienda que lo instale globalmente usando yarn:

yarn global add vtex

O, usando npm:

npm install -g vtex

Para confirmar que la instalación se realizó como se esperaba, puede ejecutar el comando vtex. Esto debería mostrar todos los comandos disponibles en un texto de ayuda.

Iniciar sesión

Una vez que se instala la CLI de VTEX IO, puede iniciar sesión en su cuenta de VTEX con el siguiente comando. Esto a su vez abriría una ventana del navegador pidiéndole sus credenciales.

$ vtex login {account}

Se debe de remplazar {account} con el nombre de la cuenta VTEX en la que está trabajando. En este caso vtex login kudosestudio

Cuando haya iniciado sesión, puede usar el comando vtex whoami para descubrir qué cuenta y espacio de trabajo está utilizando el terminal.

Creando tu propio workspace

Cuando se usa VTEX IO, cualquier interacción con una cuenta ocurre en un espacio de trabajo . Cuando inicia sesión en una tienda, se encuentra automáticamente en su espacio de trabajo maestro, lo que significa que está en la versión disponible para el usuario final. Por lo tanto, recuerde siempre crear un espacio de trabajo de desarrollo utilizando el comando vtex use cuando quiera probar una nueva configuración.

$ vtex use {examplename}

Esto cambia su Toolbelt a un workspace llamado examplename y lo crea si aún no existe.

Abrir tu tienda

Después de crear su propio workspace, puede ir a su tienda accediendo a:

https: // {workspace} - {account} .myvtex.com

Donde {workspace} es el workspace que acaba de crear (examplename) y {account} es el nombre de la cuenta en la que está trabajando (kudosestudio).

NOTA:

Simplemente puede ejecutar vtex browseen su terminal para abrir automáticamente su navegador en la https://{workspace}-{account}.myvtex.com. ¡Hecho! Puede comenzar a desarrollar su tienda en VTEX IO.

Errores

1. Error vtex.store-sitemap

Al ingresar en tu tienda, le mostrara el siguiente mensaje:

error: App build failed with message: The following peer dependency should be installed: [email protected] (from app: [email protected] -> [email protected])
error: Failed to get resolved dependencies for app [email protected]. [email protected]
error: Request failed with status code 500 [email protected]

Se soluciona instalando la dependencia strore-sitemap de la siguiente manera:

vtex install vtex.store-sitemap

2. Error de rutas

En el store-theme no trae por completo las rutas, así que se tiene agregar la ruta faltante en router.js. En este enlace encontrara las rutas por defecto del store-theme https://github.com/vtex-apps/store/blob/master/store/routes.json

:closed_book: Referencias