vtex-io-react-apps

Coordinate React components with VTEX IO interfaces.json and contentSchemas.json.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Building VTEX IO frontend apps requires coordinating React components with Store Framework interfaces, Site Editor schemas, and admin UI guidelines. This Skill provides a cohesive approach to develop VTEX IO React apps that connect blocks to interfaces, editors to schemas, and styling with CSS Handles.

Core Features & Use Cases

  • Build storefront components and admin panels that integrate with interfaces.json and contentSchemas.json
  • Enforce VTEX Styleguide for admin UIs and consistent styling with vtex.css-handles
  • Enable Site Editor integration through proper interfaces and JSON schemas for prop editing
  • Reuse components across storefront blocks and admin apps to accelerate development

Quick Start

Set up a VTEX IO React app structure wired with interfaces.json and contentSchemas.json to enable storefront blocks and admin components.

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 VTEX IO React components that integrate with the Site Editor?

To build VTEX IO React components for the Site Editor, you coordinate React blocks with interfaces.json declarations and contentSchemas.json. This wiring connects storefront components to the Store Framework, enabling prop editing directly within the admin Site Editor.

What is the purpose of interfaces.json in a VTEX IO storefront app?

Interfaces.json in a VTEX IO storefront app declares the interface schemas that connect React components to the Store Framework. It maps block definitions, allowing the Site Editor to recognize and render custom storefront components and their editable properties.

How do I apply CSS Handles to style VTEX IO storefront components?

You apply CSS Handles to style VTEX IO storefront components by using the vtex.css-handles package. This enforces standardized styling, allowing users to safely customize storefront blocks via CSS without altering the underlying React component structure.

Do I need to follow the VTEX Styleguide for admin panel React apps?

Yes, you must follow the VTEX Styleguide when building admin panel React apps. Adhering to styleguide rules ensures your admin UIs maintain consistent design, accessibility, and standardized component wiring across the VTEX IO ecosystem.

Can I reuse the same React component across storefront blocks and admin apps?

Yes, you can reuse React components across both storefront blocks and admin apps. Coordinating interfaces.json and contentSchemas.json allows developers to accelerate development by sharing component logic across different VTEX IO app surfaces.

Why are my VTEX IO custom blocks not showing up in the Site Editor?

VTEX IO custom blocks may not appear in the Site Editor if their interface declarations are missing from store/interfaces.json or lack proper contentSchemas.json definitions. Properly wiring root-level React exports to the Store Framework resolves this visibility issue.