deco-apps-vtex-porting

Port VTEX Deco apps to TanStack Start apps-start by mapping architectures and replacing platform-specific patterns.

5|2|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/decocms/deco-start --skill deco-apps-vtex-porting
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deco-apps-vtex-porting
Source: https://github.com/decocms/deco-start/tree/main/.cursor/skills/deco-apps-vtex-porting
Command: npx skills add https://github.com/decocms/deco-start --skill deco-apps-vtex-porting

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This capability helps teams port VTEX Deco apps to TanStack Start apps-start, enabling architecture parity and smooth migration with a structured reference.

Core Features & Use Cases

  • Provides a comprehensive porting guide covering app structure, loader consolidation, and SDK adaptation.
  • Documents recommended patterns, including how to replace Deno/Fresh with Node/React ecosystems and how to map VTEX to schema.org types.
  • Use Case: Port a large Deco storefront's apps-start port to achieve feature parity with the original production codebase.

Quick Start

Port a Deco VTEX app by following the guide to map loaders, actions, middlewares, and utilities to apps-start equivalents.

Frequently Asked Questions about deco-apps-vtex-porting

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

FAQPage Schema
How do I port a VTEX Deco app to TanStack Start?

This capability ports VTEX Deco apps to TanStack Start apps-start by mapping architectures and replacing platform-specific patterns. It covers core modules like loaders, actions, middleware, hooks, and utilities with validation and testing parity.

What is the best way to replace Deno and Fresh patterns when migrating to TanStack Start?

The best way to replace Deno/Fresh patterns during migration is by adapting them to the Node/React ecosystem. The porting guide documents recommended patterns for replacing these platform-specific implementations to achieve architecture parity.

How do I map VTEX data structures to schema.org types during a TanStack Start migration?

Mapping VTEX to schema.org types is handled through structure-map files and adaptation-pattern guidance. This ensures data structures are correctly translated when moving from Deco CX to apps-start.

Does porting a Deco storefront to TanStack Start require cross-checks and testing parity?

Yes, the migration enforces cross-checks, validation, and testing parity. These steps are required to ensure feature parity with the original production codebase and a smooth migration across environments.

Can I consolidate loaders and actions when porting VTEX Deco apps?

Yes, the porting guide provides comprehensive instructions for loader consolidation. It maps loaders and actions to their apps-start equivalents to streamline the VTEX Deco app migration.

What are the limitations of porting large Deco storefronts to TanStack Start?

Porting large Deco storefronts requires careful structure-map and adaptation-pattern implementation to avoid losing functionality. Strict adherence to validation and testing parity is necessary to overcome architecture mismatch limitations.