# Blocks Next (unreleased preview)

> 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)

> This index explicitly includes proposed Next contracts and engineering handoffs.
> These are design documentation, not a supported installation or migration guide.

## Blocks — Getting started

- [Blocks Next](https://docs.decocms.com/storefront/blocks/next.md) [UNRELEASED PREVIEW]: Configuration management for humans and agents, built into your codebase.

## Blocks — Getting started

- [How it works](https://docs.decocms.com/storefront/blocks/next/how-it-works.md) [UNRELEASED PREVIEW]: Follow a headline change from a typed component through generated editing fields, saved JSON, and publishing to the rendered website.
- [Quickstart](https://docs.decocms.com/storefront/blocks/next/quickstart.md) [UNRELEASED PREVIEW]
- [Migrating from v7](https://docs.decocms.com/storefront/blocks/next/renames-and-migrations.md) [UNRELEASED PREVIEW]: Keep v7 content working with aliases, replace v7 loaders, actions, telemetry and analytics, fold site settings into the CMS block, and migrate saved content safely.

## Blocks — Blocks

- [Blocks](https://docs.decocms.com/storefront/blocks/next/blocks.md) [UNRELEASED PREVIEW]: A block is a function call written as JSON. The function is code; the call is data, so editors, agents and tools can change it without touching code.
- [Saved blocks](https://docs.decocms.com/storefront/blocks/next/saved-blocks.md) [UNRELEASED PREVIEW]: Save a block under a name, refer to it from anywhere, and override its arguments for one use. Saved blocks are JSON files in .deco/blocks.
- [Built-in blocks](https://docs.decocms.com/storefront/blocks/next/built-in-blocks.md) [UNRELEASED PREVIEW]: Nine functions every block map gets for free (lazy, multivariate, always, never, date, page, redirect, cms-settings and secret), and how to replace or change one.

## Blocks — Built on Blocks

- [Forms from types](https://docs.decocms.com/storefront/blocks/next/schema.md) [UNRELEASED PREVIEW]
- [Site editor](https://docs.decocms.com/storefront/blocks/next/site-editor.md) [UNRELEASED PREVIEW]
- [Checking content](https://docs.decocms.com/storefront/blocks/next/checking.md) [UNRELEASED PREVIEW]
- [Matchers and variants](https://docs.decocms.com/storefront/blocks/next/matchers-and-variants.md) [UNRELEASED PREVIEW]: Publish campaign dates ahead of time and select content when a page resolves. Cache and rendering policy determine when visitors see a switch.
- [Lazy blocks](https://docs.decocms.com/storefront/blocks/next/lazy-blocks.md) [UNRELEASED PREVIEW]: Every argument runs before its function, except a lazy block, which runs only when the function calls it. Ask for one by typing a prop as Lazy<T>.

## Blocks — Content and data

- [Content and loaders](https://docs.decocms.com/storefront/blocks/next/content.md) [UNRELEASED PREVIEW]: deco content turns your saved blocks into a module your bundler packs. createCMS reads it, or a loader you write fetches content from somewhere else.
- [Calling APIs](https://docs.decocms.com/storefront/blocks/next/upstream-clients.md) [UNRELEASED PREVIEW]: Deco CMS doesn't fetch data. Sites call commerce, search and email platforms through thin, instrumented API clients, and this page shows how to use and write one.
- [Releases and drafts](https://docs.decocms.com/storefront/blocks/next/releases-and-drafts.md) [UNRELEASED PREVIEW]: A release is the content everyone sees. A draft is another set of calls your same code runs. Preview is your app rendering a draft.
- [Deployment](https://docs.decocms.com/storefront/blocks/next/releases-and-deployment.md) [UNRELEASED PREVIEW]

## Blocks — Websites

- [Pages and routing](https://docs.decocms.com/storefront/blocks/next/routing.md) [UNRELEASED PREVIEW]
- [Rendering](https://docs.decocms.com/storefront/blocks/next/rendering.md) [UNRELEASED PREVIEW]
- [Next.js App Router](https://docs.decocms.com/storefront/blocks/next/nextjs.md) [UNRELEASED PREVIEW]: Render Deco CMS pages in the Next.js App Router with Server Components, generate metadata from the page's SEO block, and stream each block.
- [TanStack Start](https://docs.decocms.com/storefront/blocks/next/tanstack-start-descriptors.md) [UNRELEASED PREVIEW]: Render Deco CMS pages with TanStack Start on Cloudflare Workers, streaming each block as a descriptor.
- [TanStack Start with React Server Components](https://docs.decocms.com/storefront/blocks/next/tanstack-start-rsc.md) [UNRELEASED PREVIEW]: Switch the TanStack Start guide to React Server Components, so blocks return JSX and only Client Components ship JavaScript.

## Blocks — Monitoring

- [Telemetry](https://docs.decocms.com/storefront/blocks/next/telemetry.md) [UNRELEASED PREVIEW]: Send errors, metrics and traces from your servers to your own OpenTelemetry collector or to the hosted Deco CMS, with switches and sample rates kept in the CMS settings block.
- [Analytics](https://docs.decocms.com/storefront/blocks/next/analytics.md) [UNRELEASED PREVIEW]: Privacy-friendly page views, with no cookies, compatible with One Dollar Stats, with settings kept in the CMS settings block.

## Blocks — Production

- [Caching](https://docs.decocms.com/storefront/blocks/next/caching.md) [UNRELEASED PREVIEW]: The caches a request passes through, who owns each one, and what to key it by.
- [Troubleshooting](https://docs.decocms.com/storefront/blocks/next/troubleshooting.md) [UNRELEASED PREVIEW]: Common symptoms, from UNKNOWN_BLOCK to missing telemetry, and what to check for each.

## Blocks — Reference

- [API reference](https://docs.decocms.com/storefront/blocks/next/api-reference.md) [UNRELEASED PREVIEW]
- [CLI](https://docs.decocms.com/storefront/blocks/next/cli.md) [UNRELEASED PREVIEW]

## Blocks — Hosted Deco CMS

- [The hosted Deco CMS](https://docs.decocms.com/storefront/blocks/next/hosted.md) [UNRELEASED PREVIEW]: What the hosted Deco CMS adds on top of the open-source Deco CMS, what it doesn't do, and how to connect a site to it with a site ID and token.
- [Editing in the site editor on GitHub](https://docs.decocms.com/storefront/blocks/next/hosted-site-editor.md) [UNRELEASED PREVIEW]: With the hosted Deco CMS, the site editor edits your GitHub repository directly, with nothing to clone or install: saves are commits on a draft branch, and publishing brings them to production.
- [Previewing drafts](https://docs.decocms.com/storefront/blocks/next/hosted-drafts.md) [UNRELEASED PREVIEW]: With the hosted Deco CMS, the site editor opens your real site with a ?__draft= link and the draft renders in place, with no preview deploy.
- [Publishing without a deploy](https://docs.decocms.com/storefront/blocks/next/hosted-publishing.md) [UNRELEASED PREVIEW]: With the hosted Deco CMS, production commits prepare immutable releases; promotion and rollback reach running servers on their next background check.
- [Hosted telemetry](https://docs.decocms.com/storefront/blocks/next/hosted-telemetry.md) [UNRELEASED PREVIEW]: Send your site's telemetry to the hosted Deco CMS collector with a site ID and token, with no collector to run.

## Blocks — Engineering reference

- [How Deco works inside](https://docs.decocms.com/storefront/blocks/next/internals.md) [UNRELEASED PREVIEW]
- [How resolution works](https://docs.decocms.com/storefront/blocks/next/how-resolution-works.md) [UNRELEASED PREVIEW]
- [How hosted releases stay current](https://docs.decocms.com/storefront/blocks/next/hosted-releases-internals.md) [UNRELEASED PREVIEW]
- [How matchRoute matches](https://docs.decocms.com/storefront/blocks/next/router-internals.md) [UNRELEASED PREVIEW]
- [Content protocol](https://docs.decocms.com/storefront/blocks/next/content-protocol.md) [UNRELEASED PREVIEW]: How the site editor reads and writes saved blocks without running your code. Four JSON-RPC methods over one endpoint, served by deco serve and by the site editor's GitHub backend.
- [Site editor compatibility](https://docs.decocms.com/storefront/blocks/next/studio-compatibility.md) [UNRELEASED PREVIEW]
- [How telemetry is sent](https://docs.decocms.com/storefront/blocks/next/telemetry-internals.md) [UNRELEASED PREVIEW]
- [Design decisions](https://docs.decocms.com/storefront/blocks/next/design-decisions.md) [UNRELEASED PREVIEW]
- [Production delivery and rollback](https://docs.decocms.com/storefront/blocks/next/content-delivery.md) [UNRELEASED PREVIEW]: Immutable JSON assets, a small channel manifest, and fast content rollback without builds or GitHub reads.
- [Keeping drafts current](https://docs.decocms.com/storefront/blocks/next/draft-synchronization.md) [UNRELEASED PREVIEW]: Automatically incorporate published Git content into editor drafts, with file-level draft-wins selection and no JSON merge downloads.
- [Studio implementation handoff](https://docs.decocms.com/storefront/blocks/next/studio-implementation.md) [UNRELEASED PREVIEW]: Where to implement managed drafts, automatic synchronization, immutable delivery and fast rollback in Studio, with contracts and acceptance scenarios.
- [Next framework readiness](https://docs.decocms.com/storefront/blocks/next/roadmap.md) [UNRELEASED PREVIEW]: Release blockers and readiness evidence for the proposed next Blocks framework, preserved from PR #585.