VTEX IO: guia completa para desarrolladores e-commerce

VTEX IO es el runtime de desarrollo de VTEX que permite crear aplicaciones personalizadas usando TypeScript, React y GraphQL. A diferencia del CMS legado, IO ofrece un ecosistema moderno con builders especializados, deploy atómico y aislamiento por workspace.

Builders: cada uno con su función

IO organiza el código en builders. React renderiza componentes de storefront. Node crea backends con middleware Express-like. GraphQL expone schemas y resolvers. Messages maneja internacionalización. Store arma bloques del Store Framework. Cada builder tiene su directorio y su ciclo de build.

Custom Apps: cuando lo estándar no alcanza

Apps personalizadas resuelven lo que el ecosistema estándar no cubre: reglas de negocio específicas, integraciones con sistemas internos, extensiones de checkout y automatizaciones. Una app VTEX IO es un paquete con manifest.json, políticas de acceso declaradas y deploy via vtex publish.

Workflow de desarrollo

El desarrollo en IO sigue un ciclo: vtex link para desarrollo local con hot reload, vtex deploy para publicar en el workspace de prueba, vtex install para instalar en producción. Workspaces permiten probar cambios sin afectar la tienda en producción.

Performance en VTEX IO

Apps mal escritas son la principal causa de lentitud en tiendas VTEX. Evita fetch en cascada, usa cache de GraphQL con maxAge y stale, minimiza el JavaScript enviado al client y prefiere server-side rendering siempre que sea posible.