vtex-io-react-apps

Builds VTEX IO React components for storefront blocks and admin panels using interfaces.json and GraphQL data fetching via useQuery.

39|9|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/vtexdocs/ai-skills --skill vtex-io-react-apps
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vtex-io-react-apps
Source: https://github.com/vtexdocs/ai-skills/tree/main/tracks/vtex-io/skills/vtex-io-react-apps
Command: npx skills add https://github.com/vtexdocs/ai-skills --skill vtex-io-react-apps

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

VTEX IO frontend development often requires coordinating React components, Store Framework blocks, and Site Editor metadata across storefronts and admin interfaces. This skill provides a structured approach to building VTEX IO frontend apps, ensuring consistent interfaces, styling, and editor integration.

Core Features & Use Cases

  • Scaffolds VTEX IO React components for storefront blocks and admin panels.
  • Ensures Site Editor compatibility via interfaces.json and contentSchemas.json.
  • Aligns with VTEX Styleguide for admin UIs and supports css-handles styling for storefronts.
  • Useful for creating pixel apps, custom storefront components, and admin panels within the VTEX IO React builder.

Quick Start

Follow the skill’s guidance to scaffold a VTEX IO React component project for storefront blocks and admin panels.

Frequently Asked Questions about vtex-io-react-apps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a custom storefront component for VTEX IO?

To build a custom storefront component for VTEX IO, you create a React app using the VTEX IO React Builder, export components from the root /react directory, and map them as blocks using interfaces.json for Store Framework integration.

How do I integrate a React component with the VTEX Site Editor?

Integrating a React component with the VTEX Site Editor requires defining interfaces.json for block mapping and contentSchemas.json to establish editable content schemas, allowing merchants to customize component properties directly within the editor.

What is the best way to style storefront components in VTEX IO?

The best way to style storefront components in VTEX IO is by using vtex.css-handles, which provides consistent CSS class naming and allows external styling overrides while adhering to VTEX Store Framework styling standards.

Can I use GraphQL to fetch data in VTEX IO React apps?

Yes, you can fetch data in VTEX IO React apps using GraphQL with the useQuery hook, enabling efficient data retrieval for storefront blocks and admin interfaces directly within your React components.

Do I need the VTEX Styleguide for admin panel interfaces?

Yes, building admin panel interfaces in VTEX IO requires aligning with the VTEX Styleguide, ensuring UI consistency and proper component behavior within the VTEX admin environment.

Why does my VTEX IO storefront block not appear in the Site Editor?

If a VTEX IO storefront block does not appear in the Site Editor, it likely lacks proper interfaces.json mapping or root-level exports in the /react directory, preventing the Store Framework from registering the component.