deco-to-tanstack-migration
Installation
SKILL.md
Deco-to-TanStack-Start Migration Playbook
Phase-based playbook for converting deco-sites/* storefronts from Fresh/Preact/Deno to TanStack Start/React/Cloudflare Workers. Battle-tested on a production storefront (100+ sections, VTEX, async rendering).
Architecture Boundaries
| Layer | npm Package | Purpose | Must NOT Contain |
|---|---|---|---|
| @decocms/start | @decocms/start |
CMS resolution, DecoPageRenderer, worker entry, sdk (useScript, signal, clx) | Preact shims, widget types, site-specific maps |
| @decocms/apps | @decocms/apps |
VTEX/Shopify loaders, commerce types, commerce sdk (useOffer, formatPrice, analytics) | Passthrough HTML components, Preact/Fresh refs |
| Site repo | (not published) | All UI: components, hooks, types, routes, styles | No compat/ layer, no aliases beyond ~ |