vtex-io-app-structure

Define and validate VTEX IO app structure in manifest.json and builder configurations.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing VTEX IO app structure across manifest.json, service.json, and builder configurations can be error-prone and time-consuming.

Core Features & Use Cases

  • Defines and validates the essential structure of a VTEX IO app, including manifest.json, builders, policies, dependencies, and lifecycle management.
  • Guides scaffolding of new VTEX IO apps and troubleshooting deployment issues related to app structure and naming conventions.
  • Use case: you are creating a new VTEX IO app and need correct manifest and builder setup to ensure smooth deployment.

Quick Start

Create or adjust your VTEX IO app's manifest.json and related files using this skill to ensure proper builder declarations, policies, and dependencies.

Frequently Asked Questions about vtex-io-app-structure

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

FAQPage Schema
How do I configure the manifest.json for a new VTEX IO app?

Configuring a VTEX IO app manifest.json requires defining builders, policies, dependencies, and peerDependencies sections to validate the app architecture and enable successful deployment.

What is the correct structure for VTEX IO app builders and policies?

The correct VTEX IO app structure requires declaring specific builders and policies within the manifest.json file to enforce app architecture, manage permissions, and validate the app lifecycle during deployment.

Why does my VTEX IO app deployment fail with manifest validity errors?

VTEX IO app deployment failures related to manifest validity occur when the manifest.json lacks proper builder declarations, policies, dependencies, or peerDependencies required by the app lifecycle and naming conventions.

When do I need peerDependencies in a VTEX IO app manifest?

You need peerDependencies in a VTEX IO app manifest when your app architecture requires relying on dependencies provided by the host environment rather than bundling them, ensuring correct builder configuration and deployment stability.

Can I use this approach to scaffold VTEX IO apps and troubleshoot service.json?

Yes, you can use this app structure blueprint to scaffold new VTEX IO apps, configure service.json, and troubleshoot deployment issues by enforcing proper manifest.json sections, builders, and app lifecycle management.

What is the best way to manage VTEX IO app architecture and lifecycle?

The best way to manage VTEX IO app architecture is by enforcing a comprehensive manifest and builder configuration blueprint that validates dependencies, policies, and service.json to streamline the app lifecycle.