deco-apps-vtex-porting
Installation
SKILL.md
Porting deco-cx/apps to @decocms/apps-start
Philosophy
The original deco-cx/apps is the source of truth. It runs on thousands of stores in production. The goal of apps-start is NOT to reinvent — it's to mirror the same logic, adapted only where the platform forces a change (Deno→Node, Fresh→TanStack, Preact signals→React/TanStack Query).
When in doubt about how something should work, look at the original first.
Sub-documents
| Document | Topic |
|---|---|
| structure-map.md | File-by-file mapping: original → apps-start (what exists, what's missing, what's wrong) |
| adaptation-patterns.md | How to convert each Deno/Fresh/Deco pattern to TanStack/Node |
| commerce-porting.md | Porting the commerce/ module (types, utils, SDK, components) |
| website-porting.md | Where website/ code goes (framework, storefront, worker entry) |
| transform-mapping.md | Field-by-field VTEX → schema.org mapping in transform.ts |
| deco-apps-vtex-review | Cookie propagation, auth headers, session handling (full audit checklist) |