• FeaturesFF2DVWFee5E9Deaa06SPatt525Rtuu1PDRurrQIXVreePAFFessMC1Bs
  • The repoTTE5JSThh4HOMhee5UTEe rrHW3YreeP6Z5eppHHTLpooBJI1o
  • ShowcaseSSILEWShh4HOMhoo2VBHowwZE8DwccJ51ScaaSI5Oass7Y08seeE0VSe
  • PricingPPJ9YUPrrMT1FriiBRQHiccYV4Rcii6UBTinnP2QYnggUH8Zg
  • FAQFF2DVWFAAKYM9AQQUFGFQ
  • BlogBBNW4OBllFH2Qloo2VBHoggCSKRg
BlogBBNW4OBllFH2Qloo2VBHoggCSKRgRoadmapRRB839RooEBT1oaa06SPadd598Ndmm1L42maaSI5OappHHTLpGet accessGGLLEKGee5E9DettN10Ut aaV65OaccTALDcccSOAUceeE0VSess3N01sssK9UQsPrivacy PolicyPPJ9YUPrrMT1FriiBRQHivvARX0vaaV65OaccTALDcyyYDVSy PPGYRAPoo5WCToll335UliiZ5SPicc3CABcyy8BITyTerms Of ServiceTTE5JSTee5E9DerrVGJIrmm2RPBmss61D0s OOP57JOffDKXJf SSNYCUSee24K7errR11Frvv37EYviiBFFDicc0IKNcee7CD4e

© 2026 The Content Architecture

Decided once. Committed.

The Sanity setup you stop rebuilding.

Page builder, fetch layer, draft mode, Studio structure. Every hard call made once over six years and committed. An agent gives you a different architecture every run. This one is already decided.
For engineers who work in Next.js and Sanity. Not a no-code tool.
GetGGLLEKGee5E9DettN10Ut
accessaaKVRLacc7FXPcccN99OceeKE11ess61D0sss17LUs
INPUT VERIFIED LOC:ROOT SN: TCA-2026-001 STATUS: ACTIVE. v1.0.0 NEXT 16.x SANITY v6 TS: STRICT
INPUT VERIFIED​LOC:ROOT​SN: TCA-2026-001​STATUS: ACTIVE​
v1.0.0​NEXT 16.x​SANITY v6​TS: STRICT​
Common problems
001 Page builder schema + section registration + preview ~5 HRS. 002 Draft mode + live preview + webhook revalidation ~4 HRS. 003 CDN vs. data cache — stale content after publish ~3 HRS. 004 Studio structure editors can actually use ~3 HRS. 005 SEO metadata, OG images, sitemaps, robots.txt ~2 HRS. 006 Rewriting the same 12 components ~2 HRS. 007 Redirects, analytics, view transitions, Mux ~2 HRS. 008 Contact form + spam guard + Resend wiring ~1 HR. 009 ESLint, Prettier, Biome, git hooks ~1 HR. 010 Basic auth for staging environments ~1 HR. ESTIMATED TIME LOST: ~24 HOURS PER PROJECT (3 FULL DAYS)
001Page builder schema + section registration + preview~5 HRS
002Draft mode + live preview + webhook revalidation~4 HRS
003CDN vs. data cache — stale content after publish~3 HRS
004Studio structure editors can actually use~3 HRS
005SEO metadata, OG images, sitemaps, robots.txt~2 HRS
006Rewriting the same 12 components~2 HRS
007Redirects, analytics, view transitions, Mux~2 HRS
008Contact form + spam guard + Resend wiring~1 HR
009ESLint, Prettier, Biome, git hooks~1 HR
010Basic auth for staging environments~1 HR
ESTIMATED TIME LOST: ~24 HOURS PER PROJECT (3 FULL DAYS)

The page builder alone costs you days. Every single time.

It's never the easy stuff that hurts. It's the page builder, modeled from scratch again. Draft mode and live preview, wired up and subtly broken again. The cache bug where published content goes stale and the client swears you shipped something wrong. A Studio structure your editors actually understand, instead of one they email you about.
This is the part nobody quotes for and everybody rebuilds. Days gone before the real work starts.

Every decision already made. So you can skip to the actual work.

The Content Architecture is the production foundation underneath my client work. Hundreds of choices, schema, fetching, structure, SEO, made once over six years and committed. Not a starter you outgrow in a month. Clone it, rename it, ship. The architecture is fixed; the tools are defaults you can swap.

  • 001 / Schema as a system

    Document roles, factory functions, singletons. Every schema looks the same, so every editor knows where to go. You never model the structure from scratch again.

  • 002 / The hard fields, already built

    The three fields nobody gets right the first time. A link field that handles internal refs, external URLs, email, and params. A media field that normalizes image, Mux, Rive, and Lottie into one shape, each returning dimensions, so you forget layout shift. A page builder with guardrails. Reusable, typed, composed everywhere.

  • 003 / Agent-native

    Ask an agent to build this and you get a different architecture every run, all plausible, none decided. Here the decisions are made. AGENTS.md and a dozen scoped skills let any agentic tool ingest the conventions instead of inventing them, and preconfigured MCP servers let it read the Next.js runtime and drive a real Chrome to check its own work. No drift.

  • 004 / Fetch layer, solved

    CDN bypassed in production, Data Cache doing the work, webhooks invalidating on publish, draft mode wired in. Stale content after publish stops being a midnight problem.

  • 005 / A Studio editors actually use

    Every document type where editors expect it. Pages own their routes, singletons stay locked, no hunting. Clients stop emailing to ask where their homepage lives.

  • 006 / SEO, done not deferred

    Per-page metadata from schema, sitemap driven by Sanity, OpenGraph with auto-cropped images, robots.txt included. Nothing bolted on the week before launch.

  • 007 / Production-ready from day one

    Basic auth, spam-protected forms, redirects managed in Sanity, analytics, view transitions. The plumbing you reconfigure every project, already wired.

  • 008 / Wired up, not just cloned

    An interactive setup script provisions the Sanity project, mints the tokens, adds CORS, and registers the revalidation webhook, then writes your .env. Export and migration scripts back up production and move content between environments. The first run is handled, not documented.

This is the actual repo.
                      • GET-ACCESS.md
                      README.md
                      1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
                      # The Content Architecture

A modern Next.js 16 starter with Sanity CMS integration.

## Features

- Next.js 16 with App Router and Server Components
- Sanity CMS with in-app Studio
- TypeScript 6, Tailwind CSS 4, and Biome
- Reusable components, page builder sections, and rich text blocks
- Draft mode with Sanity Live, SEO helpers, and ISR revalidation
- **HTTP Basic Auth (optional):** `proxy.ts` gates the site or individual URLs using
  `BASIC_AUTH_*` environment variables and CMS toggles (Site -> Security, per-entry
  "Password protect"). See [`docs/features/basic-auth.md`](docs/features/basic-auth.md).
- **llms.txt for AI assistants:** an editable, AI-generated `/llms.txt` (per llmstxt.org),
  drafted from your content with Sanity Agent Actions from the Site document's Agents tab.
  See [`docs/features/llms-txt.md`](docs/features/llms-txt.md).
- **Agent Markdown (content negotiation):** pages and articles serve a token-light Markdown version
  to agents that send `Accept: text/markdown`, on the same URL. Generated and stored per page from
  the Agents tab, then served verbatim. See [`docs/features/agent-markdown.md`](docs/features/agent-markdown.md).
- Feature modules for redirects, Umami analytics, view transitions, Mux and
  native video, and spam prevention
- Scaffolding via Plop for repeatable section/block generation
- Seed dataset of example content (pages, articles, media), imported with `npm run sanity:dataset-import`
- [`@mantine/hooks`](https://mantine.dev/hooks/getting-started/) for shared React hooks;
  `features/dom/use-breakpoint.ts` wraps `useMediaQuery` for Tailwind-aligned
  breakpoints and touch detection

## Getting Started

**New here? Start with [`GETTING-STARTED.md`](GETTING-STARTED.md).** It is the guided, top to bottom path
from a fresh clone to your first rendered section. The sections below are the reference.

### Prerequisites

- Node.js >= 24.15.0
- npm >= 11.6.2

### Installation

```bash
npm install
```

### Environment Variables

Create a `.env` file and add at least:

```env
SANITY_API_VIEW_TOKEN=your-view-token
SANITY_API_EDIT_TOKEN=your-edit-token
SANITY_REVALIDATE_SECRET=your-revalidate-secret
RESEND_API_KEY=your-resend-api-key
RESEND_EMAIL_FROM=notifications@your-domain.com
NEXT_PUBLIC_URL=http://localhost:3000
NEXT_PUBLIC_SANITY_DATASET=production
NEXT_PUBLIC_SANITY_PROJECT_ID=your-project-id
NEXT_PUBLIC_SANITY_API_VERSION=2025-02-19
NEXT_PUBLIC_SANITY_STUDIO_BASE_PATH=/studio
```

`NEXT_PUBLIC_SANITY_STUDIO_BASE_PATH` is the public URL for Studio. The app mounts
Studio under `app/sanity-studio/`; `next.config.ts` rewrites the public path to that
folder. See [`docs/sanity/studio-and-structure.md`](docs/sanity/studio-and-structure.md).

### HTTP Basic Auth (optional)

For staging or client-review gates, set `BASIC_AUTH_USERNAME` and `BASIC_AUTH_PASSWORD`
in the same environment as the app. Turn protection on in Sanity (site-wide and/or
per document with "Password protect"); credentials are not stored in the CMS. Full
behavior: [`docs/features/basic-auth.md`](docs/features/basic-auth.md).

### Development

```bash
npm run dev
```

- App: [http://localhost:3000](http://localhost:3000)
- Studio: `http://localhost:3000` + your `NEXT_PUBLIC_SANITY_STUDIO_BASE_PATH`

### Build

```bash
npm run build
npm run start
```

## Docs

Feature-level docs live in `docs/` so the root README stays lightweight.

- Documentation hub: [`docs/README.md`](docs/README.md)
- HTTP Basic Auth (env + CMS toggles, `proxy.ts`): [`docs/features/basic-auth.md`](docs/features/basic-auth.md)
- Redirects: [`docs/features/redirects.md`](docs/features/redirects.md)
- Code generation (Plop): [`docs/features/code-generation.md`](docs/features/code-generation.md)
- Spam prevention: [`docs/features/spam-prevention.md`](docs/features/spam-prevention.md)
- Umami tracking: [`docs/features/umami-tracking.md`](docs/features/umami-tracking.md)
- View transitions: [`docs/features/view-transitions.md`](docs/features/view-transitions.md)
- Git hooks: [`docs/features/git-hooks.md`](docs/features/git-hooks.md)
- Agent skills: [`docs/features/agent-skills.md`](docs/features/agent-skills.md)
- Dataset export and migration: [`docs/sanity/dataset-migration.md`](docs/sanity/dataset-migration.md)
- Sanity project setup: [`docs/sanity/project-setup.md`](docs/sanity/project-setup.md)

## Scripts

- `npm run dev`: Start development server
- `npm run build`: Build for production
- `npm run start`: Start production server
- `npm run check.types`: TypeScript type checking
- `npm run check`: Run all checks
- `npm run format`: Format with Biome
- `npm run sanity:typegen`: Generate Sanity types
- `npm run plop`: Scaffold new sections and rich text blocks
- `npm run sanity:cli`: Run the Sanity CLI with `.env` loaded (via dotenvx)
- `npm run sanity:dataset-export`: Backup a dataset to `./backups/`
- `npm run sanity:dataset-import`: Import a dataset backup or the bundled seed content
- `npm run sanity:dataset-migrate`: Copy one dataset into another with confirmations
- `npm run sanity:project-setup`: Wizard for project, tokens, CORS, webhook, and `.env`

## Project Structure

```text
.
|-- app/             # Next.js App Router
|-- components/      # Shared React components
|-- features/        # Feature modules
|-- public/          # Static assets
|-- sanity/          # Sanity config, schema, structure
|-- scripts/         # Dataset and project-setup CLIs
|-- seed/            # Bundled starter content (dataset export)
|-- docs/            # Project documentation
|-- proxy.ts         # Next.js Proxy (Basic Auth: env + CMS toggles)
|-- next.config.ts   # Next.js config and rewrites
+-- env.ts           # Typed environment config
```

## Agent Skills

AI guidance for this repository lives in `AGENTS.md` and `.agents/skills/`.

## License

MIT
                      Terminal
                      ~/the-content-architecture > get-access # €399 · one-time · ENDS JUL 16
                      ~/the-content-architecture > 
                      ⎇mainUpdated yesterday

                      The work that gets remembered.

                      Real sites, shipped on The Content Architecture. With the plumbing already handled, the effort goes where it shows. The work here has been recognized by Awwwards, FWA, and CSSDA, and picked up across design directories.
                      Good Fella website built on The Content Architecture

                      Good Fella

                      House of Honey website built on The Content Architecture

                      House of Honey

                      Aspen Search

                      Anuc Home website built on The Content Architecture

                      Anuc Home

                      Edoardo Lunardi

                      Serve Robotics website built on The Content Architecture

                      Serve Robotics

                      Muralia website built on The Content Architecture

                      Muralia

                      blink website built on The Content Architecture

                      blink

                      WASL Architects website built on The Content Architecture

                      WASL

                      Creative Lives in Progress website built on The Content Architecture

                      Creative Lives in Progress

                      This site :D

                      “We shipped the Good Fella site on an early version and it saved us tons of time. Six months in, we're still building pages and sections in an afternoon without fighting the setup.”“We shipped the Good Fella site on an early version and it saved us tons of time. Six months in, we're still building pages and sections in an afternoon without fighting the setup.”

                      Julian Fella

                      Co-Founder, Good Fella

                      “Edo and I ran a client project on this together. The plumbing was already handled, so the week we'd normally lose to setup went into the creative work the client actually remembers.”“Edo and I ran a client project on this together. The plumbing was already handled, so the week we'd normally lose to setup went into the creative work the client actually remembers.”

                      Elliott Mangham

                      Founder & Frontend Engineer

                      “I opened the fetch layer and found the revalidation problem I'd burned two days on last project, already solved and committed. That one folder paid for the whole thing, and the rest is six years of decisions I'd have made the slow way.”“I opened the fetch layer and found the revalidation problem I'd burned two days on last project, already solved and committed. That one folder paid for the whole thing, and the rest is six years of decisions I'd have made the slow way.”

                      Malik Kotb

                      Web Designer & Engineer

                      010012345678910123456789/03

                      Slide 1 of 3

                      One repo. One pricing. Lifetime updates.

                      €399€301234567899012345678990123456789
                      €549€501234567894012345678990123456789
                      LAUNCH OFFER · ENDS JUL 16
                      LAUNCH OFFER · ENDS JUL 16​
                      • 001ONE-TIME FEE, NO SUBSCRIPTION
                      • 002PERPETUAL LICENSE, UNLIMITED PROJECTS
                      • 003COMMERCIAL USE, NO ATTRIBUTION
                      • 004LIFETIME UPDATES, INCLUDED
                      • 005PRIVATE GITHUB DISCUSSIONS
                      • 006DIRECT LINE TO THE MAINTAINER
                      • 007FULL SOURCE ON PURCHASE, SALES FINAL
                      • 008FOR NEXT.JS + SANITY ENGINEERS, NOT NO-CODE
                      • 009ALL PRICES IN EUR
                      GetGGLLEKGee5E9DettN10Ut
                      accessaaKVRLacc7FXPcccN99OceeKE11ess61D0sss17LUs

                      Before you buy

                      GetGGLLEKGee5E9DettN10Ut
                      accessaaKVRLacc7FXPcccN99OceeKE11ess61D0sss17LUs

                      • Next.js 16 with the App Router and React Compiler, Sanity v6, TypeScript in strict mode, Tailwind 4, and Biome for lint and format. Deploys on Vercel out of the box, and runs on Cloudflare via OpenNext.

                      • No. The opinion lives in the architecture, and the tools sit on top of it. Tailwind, Biome, Mux, Rive, Lottie, these are the defaults I reach for on most projects, wired in cleanly so they come out just as cleanly. Don't want Tailwind? Pull it. Prefer ESLint over Biome? Swap it. No Mux, Rive, or Lottie in this project? Drop them. What you are really buying is the patterns underneath, how content is modeled, fetched, and composed. The libraries are just what I ship with on 90% of my projects.
                        The Sanity layer is decoupled by design too. Every import inside the sanity/ folder is relative or an external package, nothing reaches into the Next.js app, so you can lift the whole Studio, schema, and field primitives into another project. The content layer doesn't hold you hostage to the front end.

                      • Some, yes. This is a real codebase, not a no-code template. You should be comfortable in a Sanity schema file and a Next.js project. If you are, you will feel at home in minutes. If you have never opened a schema, the article series is the best place to start before deciding.

                      • No, and I'd rather tell you here than take your money. This is a real Next.js and Sanity codebase, not a no-code tool: no visual page builder, no drag-and-drop editor. You clone the repo and write real code on top of it. If you don't work in Next.js and Sanity, it isn't for you.

                      • Yes. Unlimited projects, commercial use, no attribution required. Use it on every client site you ship. The one thing you cannot do is resell the architecture itself as a competing product.

                      • Most boilerplates give you a pile of features. This gives you decisions. Every hard call, document modeling, the fetch layer, revalidation, the link and media fields, was made once over six years and committed. It is opinionated on purpose, and it is the architecture I ship my own client work on, not a side project cleaned up for sale.

                      • A free starter gets you a clean install and the easy parts. What it leaves you is the work that actually costs the days: a page builder with guardrails, the fetch layer and revalidation, the link and media fields, a Studio structure your editors don't email you about. Those decisions are still yours to make on every project. Here they're already made, over six years of real client work, and committed. You're not paying for code you could scaffold in an afternoon. You're paying to skip the part nobody quotes for.

                      • It is built for it. AGENTS.md plus a dozen scoped skills mean any agentic tool ingests the conventions and boundaries before you write a prompt. Ask an agent to build this from scratch and you get a different architecture every run. Here the decisions are already made, so the agent works inside them instead of inventing new ones. You still read and write the real code yourself; the agent works inside the architecture, it does not write the app for you.
                        It also ships two preconfigured MCP servers. One reads the running Next.js dev server: compilation errors, routes, docs that match the installed version. The other drives a real Chrome: screenshots across viewports, performance traces, screencasts of transitions it can review frame by frame. The agent doesn't just know the conventions, it can look at the app it's changing.

                      • This is my daily driver, so I keep it current. Next.js majors, Sanity migrations, breaking plugin changes, I handle them and push the update. Your license includes every update for as long as I maintain it, which is for as long as I am using it myself.

                      • The full repo on day one, a perpetual license, and lifetime updates included, not sold as a separate tier. One payment, no subscription. You own it forever.

                      • Buyers get a private GitHub Discussions space, threaded and searchable, where I answer questions directly. For anything bigger, I am reachable by email. What you will not find is a Discord to get lost in or a support queue that routes you to a bot.

                      • Tell me, and it gets fixed in the codebase, usually fast. A bug you hit is a bug my own client projects will hit too, so fixing it is in my interest as much as yours. The patch ships to everyone.

                      • Because you get the full source on purchase, sales are final, the same way every serious code product works. Once the repo is cloned, it cannot be un-cloned. So I have put everything you need to decide up front: read the article series for the full reasoning, browse the real repo above, and look at the sites already shipped on it. If something is unclear before you buy, email me and I will answer honestly, sometimes that means telling you it is not the right fit.

                      • It is a set of architectural decisions, made once over six years and committed, that gets you to the real work faster. You write real code on top of it. There is no no-code editor, no UI kit or component library to theme, no auth-billing-dashboard SaaS scaffolding, and no course wrapped around it, though the article series explains the reasoning behind it. You buy it once and own it.
                      The content architecture
                       /$$$$$$$$ /$$                                                       /$$            /$$$$$$              /$$                              
|__  $$__/| $$                                                      | $$           /$$__  $$            | $$                              
   | $$   | $$$$$$$   /$$$$$$        /$$$$$$$   /$$$$$$  /$$   /$$ /$$$$$$        |__/  \ $$        /$$$$$$$  /$$$$$$  /$$   /$$  /$$$$$$$
   | $$   | $$__  $$ /$$__  $$      | $$__  $$ /$$__  $$|  $$ /$$/|_  $$_/           /$$$$$/       /$$__  $$ |____  $$| $$  | $$ /$$_____/
   | $$   | $$  \ $$| $$$$$$$$      | $$  \ $$| $$$$$$$$ \  $$$$/   | $$            |___  $$      | $$  | $$  /$$$$$$$| $$  | $$|  $$$$$$ 
   | $$   | $$  | $$| $$_____/      | $$  | $$| $$_____/  >$$  $$   | $$ /$$       /$$  \ $$      | $$  | $$ /$$__  $$| $$  | $$ \____  $$
   | $$   | $$  | $$|  $$$$$$$      | $$  | $$|  $$$$$$$ /$$/\  $$  |  $$$$/      |  $$$$$$/      |  $$$$$$$|  $$$$$$$|  $$$$$$$ /$$$$$$$/
   |__/   |__/  |__/ \_______/      |__/  |__/ \_______/|__/  \__/   \___/         \______/        \_______/ \_______/ \____  $$|_______/ 
                                                                                                                       /$$  | $$          
                                                                                                                      |  $$$$$$/          
                                                                                                                       \______/           
                                                                                                                                          
                                                                                                                                          
  /$$$$$$   /$$$$$$   /$$$$$$        /$$   /$$  /$$$$$$  /$$   /$$  /$$$$$$   /$$$$$$$                                                    
 |____  $$ /$$__  $$ /$$__  $$      | $$  | $$ /$$__  $$| $$  | $$ /$$__  $$ /$$_____/                                                    
  /$$$$$$$| $$  \__/| $$$$$$$$      | $$  | $$| $$  \ $$| $$  | $$| $$  \__/|  $$$$$$                                                     
 /$$__  $$| $$      | $$_____/      | $$  | $$| $$  | $$| $$  | $$| $$       \____  $$                                                    
|  $$$$$$$| $$      |  $$$$$$$      |  $$$$$$$|  $$$$$$/|  $$$$$$/| $$       /$$$$$$$//$$                                                 
 \_______/|__/       \_______/       \____  $$ \______/  \______/ |__/      |_______/|__/                                                 
                                     /$$  | $$                                                                                            
                                    |  $$$$$$/                                                                                            
                                     \______/