# Templates

> Storefront documents the Blocks framework, the Site Editor app, website templates, and commerce integrations.
> Studio documents the extensible platform: context, tasks, sandboxes, connectors, and MCP Apps.
> Blocks 7.x is the released default. Blocks Next is an unreleased proposal; Fresh and the former admin are retired.
> Site Editor publishing follows Git changes, a pull request, review or merge, and the configured deployment. Runtime content reload APIs are separate delivery capabilities.
> Respect availability labels. Do not describe preview, planned, or in-build APIs as available.

Any documentation page is available as Markdown by appending `.md` to its URL.

## Scoped indexes

- [Storefront — current](https://docs.decocms.com/storefront/llms.txt)
- [Studio](https://docs.decocms.com/studio/llms.txt)
- [Site Editor](https://docs.decocms.com/storefront/editor/llms.txt)
- [Templates and storefront implementation](https://docs.decocms.com/storefront/templates/llms.txt)
- [Blocks 7.x — current](https://docs.decocms.com/storefront/blocks/v7/llms.txt)
- [Blocks Next — UNRELEASED PREVIEW](https://docs.decocms.com/storefront/blocks/next/llms.txt)
- [Fresh — retired runtime archive](https://docs.decocms.com/storefront/blocks/fresh/llms.txt)
- [Former admin — retired archive](https://docs.decocms.com/storefront/legacy/llms.txt)

## Templates — Templates

- [Website templates](https://docs.decocms.com/storefront/templates/overview.md): Start with a working website implementation, then adapt its sections, content, and commerce integration.
- [Storefront TanStack](https://docs.decocms.com/storefront/templates/storefront-tanstack.md): Use the public TanStack Start storefront implementation as the starting point for your website.

## Templates — Commerce

- [Commerce overview](https://docs.decocms.com/storefront/commerce/overview.md): Configure commerce integrations for the released Blocks 7.x framework.
- [VTEX overview](https://docs.decocms.com/storefront/commerce/vtex/overview.md): Connect a released Blocks 7.x storefront to VTEX with registered provider modules.
- [VTEX loaders and actions](https://docs.decocms.com/storefront/commerce/vtex/loaders-and-actions.md): Server-side data fetch and mutation API for VTEX.
- [VTEX client and middleware](https://docs.decocms.com/storefront/commerce/vtex/client-and-middleware.md): vtexFetch family, intelligentSearch, fetchCache, extractVtexContext, propagateISCookies.
- [VTEX hooks](https://docs.decocms.com/storefront/commerce/vtex/hooks.md): Cart v2 (createCart, useAddToCart, useCartSummary), plus useCart, useUser, useWishlist, useAutocomplete for the browser.
- [VTEX inline loaders](https://docs.decocms.com/storefront/commerce/vtex/inline-loaders.md): createVtexCommerceLoaders, CMS-shaped page loaders for PDP, PLP, shelf, search.
- [VTEX gotchas](https://docs.decocms.com/storefront/commerce/vtex/gotchas.md): Cookies, sales channel, expectedOrderFormSections, regionId, IS sort sanitization, README drift.
- [Shopify](https://docs.decocms.com/storefront/commerce/shopify.md): Configure Shopify for a Blocks 7.x storefront and wire server-side products, carts, and customers.
- [Resend](https://docs.decocms.com/storefront/commerce/resend.md): Configure transactional email for a Blocks 7.x site.
- [Shared commerce](https://docs.decocms.com/storefront/commerce/shared.md): schema.org types, useOffer, formatPrice, analytics, useVariantPossibilities, Image / Picture / JsonLd.

## Templates — Migration

- [Migration overview](https://docs.decocms.com/storefront/migration/overview.md): Move a retired Fresh/Deno storefront to the released Blocks 7.x runtime.
- [Migration checklist](https://docs.decocms.com/storefront/migration/checklist.md): Walk through this list before merging a migration PR.
- [Migration playbook](https://docs.decocms.com/storefront/migration/playbook.md): Phase-by-phase walkthrough of moving a Fresh storefront to TanStack Start.
- [Migrate script](https://docs.decocms.com/storefront/migration/migrate-script.md): What npx -p @decocms/blocks-cli deco-migrate actually does.
- [Migrate from Fresh](https://docs.decocms.com/storefront/migration/migrate-from-v1.md): Move a Fresh/Deno deco.cx storefront to TanStack Start.
- [Agent skills](https://docs.decocms.com/storefront/migration/agent-skills.md): Use Claude Code, Cursor, Codex, or any AI coding tool to drive the migration.
- [Validate & capture with parity](https://docs.decocms.com/storefront/migration/parity.md): Use parity to extract a live storefront and validate the migrated site — see the Parity section.

## Templates — Migration validation

- [Parity overview](https://docs.decocms.com/storefront/migration/parity/overview.md): A CLI that captures a live storefront into an agent-ready bundle and validates a migrated site against the original.
- [parity journey](https://docs.decocms.com/storefront/migration/parity/journey.md): Run only the purchase journey, step-by-step, prod vs cand — the tightest CI loop.
- [Commands reference](https://docs.decocms.com/storefront/migration/parity/commands.md): Every parity command — inspect probes, run management, and the full flag surface.
- [Configuration](https://docs.decocms.com/storefront/migration/parity/config.md): .parityrc.json selectors + run defaults, .parityignore noise filters, and environment variables.
- [Checks reference](https://docs.decocms.com/storefront/migration/parity/checks.md): Every check parity runs, what it catches, and its module (the --only/--skip scoping key).
- [parity run](https://docs.decocms.com/storefront/migration/parity/run.md): Compare two URLs (prod × cand) and produce a parity report — with module selection for focused runs (SEO, visual, cache, vitals, DOM/CSS).
- [parity extract](https://docs.decocms.com/storefront/migration/parity/extract.md): Single-site, AI-ready component extraction — HTML, computed styles, screenshots, assets per component.
- [parity migrate](https://docs.decocms.com/storefront/migration/parity/migrate.md): Phased, target-agnostic capture of a live storefront into an agent-ready migration bundle.
- [CI/CD & workflows](https://docs.decocms.com/storefront/migration/parity/ci.md): Gate PRs with parity in GitHub Actions, and drive an AI fix loop from the report.
- [Performance (vitals & cache)](https://docs.decocms.com/storefront/migration/parity/performance.md): Compare Web Vitals and cache coverage across many pages, prod vs cand.
- [Pixel-perfect (fix & section)](https://docs.decocms.com/storefront/migration/parity/pixel-perfect.md): Diff one section between prod and cand — screenshots, pixelmatch heatmap, computed styles — into an LLM-ready bundle.
- [Single-site (e2e & audit)](https://docs.decocms.com/storefront/migration/parity/single-site.md): Validate ONE live URL end-to-end — no prod baseline. For pre-launch and partner audits.

## Templates — Hosting

- [Hosting and deployment](https://docs.decocms.com/storefront/hosting/overview.md) [IN BUILD]: Deploy your storefront, manage previews, and distinguish site hosting from Studio hosting