VTEX Developer Guide
Building Scalable Commerce
Experiences with VTEX IO
Presented by [Your Name]
What is VTEX?
• Cloud-native, headless commerce platform
• Modular and extensible architecture
• Unified storefront, CMS, catalog, and checkout
• Fast iteration and deployment via VTEX IO
VTEX Core Concepts
• VTEX IO: React and Node.js-based dev
platform
• FastStore: High-performance storefront
framework
• CMS: Visual page and block management
• Workspaces: Isolated staging for safe
development
Developer Stack
• React + VTEX Store Framework
• GraphQL APIs: Catalog, Checkout, Session
• Tooling: Git, VTEX Toolbelt, GraphQL IDE
• Typescript support, reusable components
Setting Up Your Development
Environment
• Install Node.js, Yarn, and VTEX Toolbelt
• Login: vtex login <account>
• Create workspace: vtex use dev-<name>
• Deploy and test: vtex link / vtex deploy
VTEX IO Folder Structure
• /react: React components
• /store: Storefront block and layout definitions
• /graphql: GraphQL queries and fragments
• manifest.json: App metadata and
dependencies
Creating a VTEX IO App
• Define app in manifest.json
• Build frontend in /react
• Expose blocks through /store
• Link to workspace with vtex link
Working with GraphQL
• Built-in APIs for product, session, catalog
• Use `useQuery()` or Apollo for integration
• GraphQL IDE: /_v/private/graphql-ide/
• Example: search(term: 'shoes') { products { id
name } }
CMS & Storefront Integration
• Use blocks like store.home and store.product
• Customize via JSON + Site Editor
• Enable components to be placed via CMS
• Enhance business user flexibility
Local Development Tips
• Hot-reload with vtex link
• Switch envs: vtex use <workspace>
• Inspect runtime: window.__RUNTIME__
• Clear session: vtex session --clear
Debugging & Tools
• Use browser dev tools for GraphQL requests
• Inspect manifest.json for policies
• Check GraphQL responses and logs
• CLI tools: vtex whoami, vtex ls, etc.
Deployment Workflow
• Work in a dev workspace (e.g., dev-yourname)
• Submit PR → merge to master
• Deploy to production workspace
• Promote using vtex promote
Resources & Support
• VTEX Developer Portal: developers.vtex.com
• Learning Center: learn.vtex.com
• FastStore Docs:
developers.vtex.com/docs/guides/faststore-
overview
• Join community on Slack or Discord
• Get help from help.vtex.com
Q&A
• Questions, feedback, or challenges?
• Let’s discuss VTEX projects and best practices