deco-migrate-script

To migrate a Deco storefront from Fresh and Preact to TanStack Start, you run an automated TypeScript migration script via the tsx runner from your project root. This orchestrates the entire transformation process end-to-end without manual refactoring.

The Deco storefront migration process includes seven orchestrated phases: analyze, scaffold, transform, cleanup, report, verify, and bootstrap. It generates a new project structure, rewrites imports, aligns APIs for the Start ecosystem, and runs smoke tests.

Yes, migrating a Deco storefront to Start requires the tsx runner to execute the migrate.ts entry point from the project root. The new site root must already have @decocms/start installed before running the migration script.

Yes, you can preview storefront migration changes by performing a dry run. Executing the migration script with the dry-run option previews structural changes and import rewrites before modifying your project files.

You verify a Deco to TanStack Start migration by checking the generated MIGRATION_REPORT.md and running automated smoke tests. These validation steps confirm the transformed codebase aligns correctly with the Start ecosystem.

The automated migration script only applies to compatible Deco storefront projects using Fresh, Preact, and Deno. It requires a specific scripts/migrate.ts entry point and cannot migrate projects outside this specific technology stack.