create-turbo-wizard 0.1.1 → 0.2.0

package/dist/cli.js

@@ -15,13 +15,38 @@ var __export = (target, all) => {
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 
+// ../../packages/types/src/command.ts
+function buildCommand(config) {
+  const parts = [
+    ...CREATE_PREFIX[config.packageManager],
+    `--name ${config.name}`,
+    `--frontend ${config.frontend}`,
+    `--content ${config.content}`,
+    `--package-manager ${config.packageManager}`
+  ];
+  config.deploy !== "node" && parts.push(`--deploy ${config.deploy}`);
+  config.modules.length && parts.push(`--modules ${config.modules.join(" ")}`);
+  config.experimental.cacheComponents && parts.push("--cache-components");
+  config.experimental.reactCompiler && parts.push("--react-compiler");
+  return parts.join(" ");
+}
+var CREATE_PREFIX;
+var init_command = __esm(() => {
+  CREATE_PREFIX = {
+    npm: ["npm create turbo-wizard@latest", "--"],
+    pnpm: ["pnpm create turbo-wizard@latest"],
+    bun: ["bun create turbo-wizard@latest"]
+  };
+});
+
 // ../../packages/types/src/index.ts
 import { z } from "zod";
 function applyPreset(preset, overrides = {}) {
   return { ...PRESET_CONFIGS[preset], ...overrides };
 }
-var FRONTENDS, CONTENT_SOURCES, PACKAGE_MANAGERS, MODULES, FrontendSchema, ContentSourceSchema, PackageManagerSchema, ModuleSchema, ExperimentalSchema, ProjectNameSchema, WizardConfigSchema, wizardConfigJsonSchema = () => z.toJSONSchema(WizardConfigSchema), PRESETS, PRESET_CONFIGS;
+var FRONTENDS, CONTENT_SOURCES, PACKAGE_MANAGERS, MODULES, MODULE_CATEGORIES, DEPLOY_TARGETS, FrontendSchema, ContentSourceSchema, PackageManagerSchema, ModuleSchema, DeployTargetSchema, ExperimentalSchema, ProjectNameSchema, WizardConfigSchema, wizardConfigJsonSchema = () => z.toJSONSchema(WizardConfigSchema), PRESETS, PRESET_CONFIGS;
 var init_src = __esm(() => {
+  init_command();
   FRONTENDS = ["astro", "next"];
   CONTENT_SOURCES = ["sanity", "markdown", "none"];
   PACKAGE_MANAGERS = ["pnpm", "bun", "npm"];
@@ -39,10 +64,13 @@ var init_src = __esm(() => {
     "forms",
     "llms"
   ];
+  MODULE_CATEGORIES = ["devtools", "integration", "ui", "cross-cutting"];
+  DEPLOY_TARGETS = ["node", "vercel"];
   FrontendSchema = z.enum(FRONTENDS).describe("Web framework");
   ContentSourceSchema = z.enum(CONTENT_SOURCES).describe("Content source");
   PackageManagerSchema = z.enum(PACKAGE_MANAGERS).describe("Package manager");
   ModuleSchema = z.enum(MODULES).describe("Opt-in module");
+  DeployTargetSchema = z.enum(DEPLOY_TARGETS).describe("Deploy target (Astro SSR adapter; ignored by Next)");
   ExperimentalSchema = z.object({
     cacheComponents: z.boolean().default(false),
     reactCompiler: z.boolean().default(false)
@@ -53,6 +81,7 @@ var init_src = __esm(() => {
     frontend: FrontendSchema,
     content: ContentSourceSchema.default("none"),
     packageManager: PackageManagerSchema.default("pnpm"),
+    deploy: DeployTargetSchema.default("node"),
     modules: z.array(ModuleSchema).default([]),
     experimental: ExperimentalSchema
   });
@@ -72,7 +101,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "create-turbo-wizard",
-    version: "0.1.1",
+    version: "0.2.0",
     description: "Scaffold a Turborepo monorepo: Astro or Next.js, Sanity or Markdown, opt-in modules.",
     keywords: [
       "turborepo",
@@ -289,6 +318,7 @@ ${WORKSPACE_GLOBS.map((g) => `  - "${g}"`).join(`
   "dist/",
   ".next/",
   ".astro/",
+  ".sanity/",
   ".turbo/",
   "*.tsbuildinfo",
   "",
@@ -380,8 +410,7 @@ var init_biome = __esm(() => {
     kind: "baseline",
     templates: [{ path: "biome.jsonc", content: BIOME_CONFIG }],
     scripts: { check: "biome check .", format: "biome format --write ." },
-    deps: [{ name: "@biomejs/biome", versionKey: "@biomejs/biome", target: "root", dev: true }],
-    owns: ["biome.jsonc"]
+    deps: [{ name: "@biomejs/biome", versionKey: "@biomejs/biome", target: "root", dev: true }]
   };
 });
 
@@ -426,8 +455,7 @@ var init_env = __esm(() => {
         content: j({ extends: "@workspace/typescript-config/base.json", include: ["src"] })
       },
       { path: "packages/env/src/index.ts", content: ENV_SRC }
-    ],
-    owns: ["packages/env/package.json", "packages/env/tsconfig.json", "packages/env/src/index.ts"]
+    ]
   };
 });
 
@@ -475,11 +503,6 @@ var init_logger = __esm(() => {
         content: j2({ extends: "@workspace/typescript-config/base.json", include: ["src"] })
       },
       { path: "packages/logger/src/index.ts", content: LOGGER_SRC }
-    ],
-    owns: [
-      "packages/logger/package.json",
-      "packages/logger/tsconfig.json",
-      "packages/logger/src/index.ts"
     ]
   };
 });
@@ -543,12 +566,6 @@ var init_typescript_config = __esm(() => {
           compilerOptions: { lib: ["DOM", "DOM.Iterable", "ES2023"], jsx: "react-jsx" }
         })
       }
-    ],
-    owns: [
-      "packages/typescript-config/package.json",
-      "packages/typescript-config/base.json",
-      "packages/typescript-config/nextjs.json",
-      "packages/typescript-config/react-library.json"
     ]
   };
 });
@@ -616,7 +633,8 @@ function replaceNextMetadata(content, expr) {
 }
 
 // ../../packages/registry/src/content/markdown.ts
-var NEXT_MDX_COMPONENTS = `import type { MDXComponents } from "mdx/types";
+var j4 = (value) => `${JSON.stringify(value, null, 2)}
+`, CONTENT_PACKAGE_JSON, NEXT_MDX_COMPONENTS = `import type { MDXComponents } from "mdx/types";
 
 const components: MDXComponents = {
   // Override built-ins here, e.g. h1: ({ children }) => <h1 className="...">{children}</h1>,
@@ -642,15 +660,26 @@ This post is written in **MDX** — Markdown with JSX.
 - Mix Markdown prose with interactive components
 - Full JSX expression support
 - Server Components by default
+`, NEXT_CONTENT_SCHEMA = `export interface PostMetadata {
+  title: string;
+  description?: string;
+  date?: string;
+}
 `, NEXT_BLOG_POSTS_TS = `import { readdir } from "node:fs/promises";
 import path from "node:path";
+import type { PostMetadata } from "@workspace/content/schema";
 import type { ComponentType } from "react";
 
-const POSTS_DIR = path.join(process.cwd(), "content/blog");
+// cwd is apps/web for every next command turbo runs; the posts are two levels up in the
+// workspace. In the default configuration this is read only at build time — the listing
+// prerenders and generateStaticParams enumerates the slugs. With cacheComponents on, the
+// PostList boundary below streams at request time and reads it then, exactly as it did
+// when the posts lived in apps/web/content.
+const POSTS_DIR = path.join(process.cwd(), "../../packages/content/blog");
 
 export interface PostModule {
   default: ComponentType;
-  metadata: { title: string; description?: string; date?: string };
+  metadata: PostMetadata;
 }
 
 export async function getPostSlugs(): Promise<string[]> {
@@ -665,7 +694,7 @@ async function getPosts() {
   const slugs = await getPostSlugs();
   return Promise.all(
     slugs.map(async (slug) => {
-      const { metadata } = (await import(\`@/content/blog/\${slug}.mdx\`)) as PostModule;
+      const { metadata } = (await import(\`@workspace/content/blog/\${slug}.mdx\`)) as PostModule;
       return { slug, ...metadata };
     }),
   );
@@ -719,7 +748,7 @@ export default async function BlogPostPage({
   params: Promise<{ slug: string }>;
 }) {
   const { slug } = await params;
-  const post = (await import(\`@/content/blog/\${slug}.mdx\`).catch(() => null)) as PostModule | null;
+  const post = (await import(\`@workspace/content/blog/\${slug}.mdx\`).catch(() => null)) as PostModule | null;
   if (!post) notFound();
 
   const { default: Post, metadata } = post;
@@ -733,18 +762,23 @@ export default async function BlogPostPage({
     </main>
   );
 }
-`, ASTRO_CONTENT_CONFIG = `import { glob } from "astro/loaders";
-import { defineCollection, z } from "astro:content";
+`, ASTRO_CONTENT_SCHEMA = `import { z } from "astro:content";
+
+export const blogSchema = z.object({
+  title: z.string(),
+  description: z.string(),
+  pubDate: z.coerce.date(),
+  updatedDate: z.coerce.date().optional(),
+});
+`, ASTRO_CONTENT_CONFIG = `import { blogSchema } from "@workspace/content/schema";
+import { glob } from "astro/loaders";
+import { defineCollection } from "astro:content";
 
 const blog = defineCollection({
-  // Pattern includes both .md and .mdx so the collection is mixed-format.
-  loader: glob({ pattern: "**/*.{md,mdx}", base: "./src/content/blog" }),
-  schema: z.object({
-    title: z.string(),
-    description: z.string(),
-    pubDate: z.coerce.date(),
-    updatedDate: z.coerce.date().optional(),
-  }),
+  // Pattern includes both .md and .mdx so the collection is mixed-format. \`base\` is
+  // resolved from the project root (apps/web), so it reaches out to the package.
+  loader: glob({ pattern: "**/*.{md,mdx}", base: "../../packages/content/blog" }),
+  schema: blogSchema,
 });
 
 export const collections = { blog };
@@ -822,6 +856,16 @@ const { Content } = await render(post);
 </html>
 `, markdown;
 var init_markdown = __esm(() => {
+  CONTENT_PACKAGE_JSON = j4({
+    name: "@workspace/content",
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    exports: {
+      "./schema": "./src/schema.ts",
+      "./blog/*": "./blog/*"
+    }
+  });
   markdown = {
     id: "markdown",
     kind: "content",
@@ -829,21 +873,25 @@ var init_markdown = __esm(() => {
       label: "MDX content",
       hint: "Markdown + JSX wired into the frontend (official recipe)"
     },
+    templates: [{ path: "packages/content/package.json", content: CONTENT_PACKAGE_JSON }],
     fragments: {
       next: [
+        { path: "packages/content/src/schema.ts", content: NEXT_CONTENT_SCHEMA },
+        { path: "packages/content/blog/hello.mdx", content: NEXT_BLOG_POST_MDX },
         { path: "apps/web/mdx-components.tsx", content: NEXT_MDX_COMPONENTS },
-        { path: "apps/web/content/blog/hello.mdx", content: NEXT_BLOG_POST_MDX },
         { path: "apps/web/app/blog/posts.ts", content: NEXT_BLOG_POSTS_TS },
         { path: "apps/web/app/blog/page.tsx", content: NEXT_BLOG_INDEX_TSX },
         { path: "apps/web/app/blog/[slug]/page.tsx", content: NEXT_BLOG_SLUG_TSX }
       ],
       astro: [
+        { path: "packages/content/src/schema.ts", content: ASTRO_CONTENT_SCHEMA },
+        { path: "packages/content/blog/hello.mdx", content: ASTRO_BLOG_POST },
         { path: "apps/web/src/content.config.ts", content: ASTRO_CONTENT_CONFIG },
-        { path: "apps/web/src/content/blog/hello.mdx", content: ASTRO_BLOG_POST },
         { path: "apps/web/src/pages/blog/index.astro", content: ASTRO_BLOG_INDEX },
         { path: "apps/web/src/pages/blog/[...slug].astro", content: ASTRO_BLOG_SLUG_PAGE }
       ]
     },
+    deps: [{ name: "@workspace/content", version: "workspace:*", target: "app" }],
     frontendDeps: {
       next: [
         { name: "@next/mdx", version: "^16.2.0", target: "app", dev: true },
@@ -853,17 +901,6 @@ var init_markdown = __esm(() => {
       ],
       astro: [{ name: "@astrojs/mdx", version: "^4.3.14", target: "app" }]
     },
-    owns: [
-      "apps/web/mdx-components.tsx",
-      "apps/web/content/blog/hello.mdx",
-      "apps/web/app/blog/posts.ts",
-      "apps/web/app/blog/page.tsx",
-      "apps/web/app/blog/[slug]/page.tsx",
-      "apps/web/src/content.config.ts",
-      "apps/web/src/content/blog/hello.mdx",
-      "apps/web/src/pages/blog/index.astro",
-      "apps/web/src/pages/blog/[...slug].astro"
-    ],
     patches: [
       {
         path: "apps/web/next.config.ts",
@@ -879,219 +916,393 @@ var init_markdown = __esm(() => {
   };
 });
 
-// ../../packages/registry/src/content/sanity.ts
-var SCHEMA_BLOCKS = `import { defineArrayMember, defineField, defineType } from "sanity";
-
-// Page-builder blocks are objects, not documents: they only exist inside a page.
-
-export const hero = defineType({
-  name: "hero",
-  title: "Hero",
-  type: "object",
-  fields: [
-    defineField({ name: "heading", type: "string", validation: (rule) => rule.required() }),
-    defineField({ name: "subheading", type: "text", rows: 2 }),
-    defineField({
-      name: "image",
-      type: "image",
-      options: { hotspot: true },
-      fields: [defineField({ name: "alt", type: "string", title: "Alternative text" })],
-    }),
-  ],
-  preview: {
-    select: { title: "heading", media: "image" },
-    prepare: ({ title, media }) => ({ title: title ?? "Hero", subtitle: "Hero", media }),
-  },
-});
-
-export const richText = defineType({
-  name: "richText",
-  title: "Rich text",
-  type: "object",
-  fields: [
-    defineField({ name: "heading", type: "string" }),
-    defineField({ name: "content", type: "array", of: [defineArrayMember({ type: "block" })] }),
-  ],
-  preview: {
-    select: { title: "heading" },
-    prepare: ({ title }) => ({ title: title ?? "Rich text", subtitle: "Rich text" }),
-  },
-});
+// ../../packages/registry/src/content/sanity/astro.ts
+var ASTRO_ENV = `export const projectId = import.meta.env.PUBLIC_SANITY_PROJECT_ID || "placeholder";
 
-export const cta = defineType({
-  name: "cta",
-  title: "Call to action",
-  type: "object",
-  fields: [
-    defineField({ name: "heading", type: "string", validation: (rule) => rule.required() }),
-    defineField({ name: "text", type: "text", rows: 2 }),
-    defineField({ name: "buttonLabel", type: "string" }),
-    defineField({ name: "buttonHref", type: "string" }),
-  ],
-  preview: {
-    select: { title: "heading" },
-    prepare: ({ title }) => ({ title: title ?? "Call to action", subtitle: "Call to action" }),
-  },
-});
-`, SCHEMA_PAGE = `import { defineArrayMember, defineField, defineType } from "sanity";
+export const dataset = import.meta.env.PUBLIC_SANITY_DATASET || "production";
 
-export const page = defineType({
-  name: "page",
-  title: "Page",
-  type: "document",
-  fields: [
-    defineField({ name: "title", type: "string", validation: (rule) => rule.required() }),
-    defineField({
-      name: "slug",
-      type: "slug",
-      options: { source: "title" },
-      validation: (rule) => rule.required(),
-    }),
-    defineField({ name: "description", type: "text", rows: 3 }),
-    defineField({
-      name: "pageBuilder",
-      title: "Page builder",
-      type: "array",
-      of: [
-        defineArrayMember({ type: "hero" }),
-        defineArrayMember({ type: "richText" }),
-        defineArrayMember({ type: "cta" }),
-      ],
-    }),
-  ],
-  // The home page is the \`page\` whose slug is "home" — see sanity/queries.ts.
-  preview: { select: { title: "title", subtitle: "slug.current" } },
-});
-`, SCHEMA_SETTINGS = `import { defineField, defineType } from "sanity";
+/** Server-only read token; required (and only read) when Visual Editing is enabled. */
+export const readToken = import.meta.env.SANITY_API_READ_TOKEN ?? "";
 
-export const settings = defineType({
-  name: "settings",
-  title: "Settings",
-  type: "document",
-  fields: [
-    defineField({ name: "siteTitle", type: "string", validation: (rule) => rule.required() }),
-    defineField({ name: "siteDescription", type: "text", rows: 3 }),
-    defineField({
-      name: "socialImage",
-      title: "Social share image",
-      type: "image",
-      options: { hotspot: true },
-    }),
-  ],
-  preview: { select: { title: "siteTitle", media: "socialImage" } },
-});
-`, SCHEMA_INDEX = `import type { SchemaTypeDefinition } from "sanity";
-import { cta, hero, richText } from "./blocks";
-import { page } from "./page";
-import { settings } from "./settings";
+/**
+ * The @sanity/astro Visual Editing switch. Off by default: overlays need a rendering
+ * server (\`astro dev\`, or an SSR adapter in production) plus SANITY_API_READ_TOKEN.
+ */
+export const visualEditingEnabled =
+  import.meta.env.PUBLIC_SANITY_VISUAL_EDITING_ENABLED === "true";
 
-export const schemaTypes: SchemaTypeDefinition[] = [page, settings, hero, richText, cta];
-`, STRUCTURE = `import type { StructureResolver } from "sanity/structure";
+/**
+ * False on a freshly scaffolded project. Guards every fetch so \`astro build\` never dials
+ * placeholder.api.sanity.io and dies; pages render an empty state instead.
+ */
+export const hasSanityCredentials = projectId !== "placeholder";
+`, ASTRO_FETCH = `import { sanityClient } from "sanity:client";
+import { hasSanityCredentials, readToken, visualEditingEnabled } from "./env";
 
 /**
- * \`settings\` is a singleton: one document with a fixed id, edited in place instead of
- * listed. Everything else falls through to the default document-type lists.
+ * \`sanity:client\` is a Vite virtual module and this file lives in a linked workspace
+ * package, not in apps/web. Both halves of that were measured before the move: the
+ * integration's \`resolveId\` fires for any importer in the graph, and Vite still applies
+ * its \`import.meta.env\` substitution inside the package (a pnpm workspace link resolves
+ * to a real path outside node_modules, so it is treated as source, not as an external
+ * dependency). Without the second half every read would silently short-circuit on a
+ * "placeholder" project id and every route would still answer 200.
  *
- * The two sets feed sanity.config.ts's \`document.newDocumentOptions\` / \`document.actions\`
- * guards (the official singleton recipe), so a second settings document cannot be created.
+ * The single read path, following @sanity/astro's Visual Editing recipe: with
+ * PUBLIC_SANITY_VISUAL_EDITING_ENABLED=true it fetches the drafts perspective with
+ * stega source maps, which is what gives Presentation its click-to-edit overlays.
+ *
+ * Without credentials it returns null before touching the network, so \`astro build\`
+ * succeeds on a fresh scaffold. The catch covers a configured-but-unreachable dataset
+ * for the same reason: a starter should render empty, not crash.
  */
-export const singletonTypes = new Set(["settings"]);
-
-/** Actions that keep a singleton editable without allowing create/delete/duplicate. */
-export const singletonActions = new Set(["publish", "discardChanges", "restore"]);
-
-export const structure: StructureResolver = (S) =>
-  S.list()
-    .title("Content")
-    .items([
-      S.listItem()
-        .title("Settings")
-        .id("settings")
-        .child(S.document().schemaType("settings").documentId("settings")),
-      S.divider(),
-      S.documentTypeListItem("page").title("Pages"),
-    ]);
-`, PRESENTATION = `import { defineDocuments, defineLocations } from "sanity/presentation";
-
-/** Route → document: lets Presentation open the right \`page\` for the URL in the iframe. */
-export const mainDocuments = defineDocuments([
-  { route: "/", filter: \`_type == "page" && slug.current == "home"\` },
-  { route: "/:slug", filter: \`_type == "page" && slug.current == $slug\` },
-]);
-
-/** Document → routes: the "Used on …" links shown when editing a document. */
-export const locations = {
-  settings: defineLocations({
-    locations: [{ title: "Home", href: "/" }],
-    message: "This document is used on all pages",
-    tone: "positive",
-  }),
-  page: defineLocations({
-    select: { title: "title", slug: "slug.current" },
-    resolve: (doc) => ({
-      locations: [
-        {
-          title: doc?.title || "Untitled",
-          href: doc?.slug === "home" ? "/" : \`/\${doc?.slug}\`,
-        },
-      ],
-    }),
-  }),
-};
-`, DOCUMENT_GUARD = `  document: {
-    newDocumentOptions: (prev, { creationContext }) =>
-      creationContext.type === "global"
-        ? prev.filter((template) => !singletonTypes.has(template.templateId))
-        : prev,
-    actions: (prev, { schemaType }) =>
-      singletonTypes.has(schemaType)
-        ? prev.filter(({ action }) => action && singletonActions.has(action))
-        : prev,
-  },`, QUERIES = `import { defineQuery } from "groq";
-
-const PAGE_FIELDS = /* groq */ \`
-  _id,
-  _type,
-  title,
-  description,
-  "slug": slug.current,
-  pageBuilder[]{ ... }
-\`;
-
-export const HOME_PAGE_QUERY = defineQuery(
-  \`*[_type == "page" && slug.current == "home"][0]{\${PAGE_FIELDS}}\`,
-);
+export async function loadQuery<T>(
+  query: string,
+  params: Record<string, unknown> = {},
+): Promise<T | null> {
+  if (!hasSanityCredentials) return null;
+  if (visualEditingEnabled && !readToken) {
+    throw new Error(
+      "SANITY_API_READ_TOKEN is required when PUBLIC_SANITY_VISUAL_EDITING_ENABLED is true.",
+    );
+  }
+  try {
+    const { result } = await sanityClient.fetch<T>(query, params, {
+      filterResponse: false,
+      perspective: visualEditingEnabled ? "drafts" : "published",
+      resultSourceMap: visualEditingEnabled ? "withKeyArraySelector" : false,
+      stega: visualEditingEnabled,
+      ...(visualEditingEnabled ? { token: readToken } : {}),
+      useCdn: !visualEditingEnabled,
+    });
+    return result;
+  } catch (error) {
+    console.warn("[sanity] query failed:", error);
+    return null;
+  }
+}
+`, ASTRO_IMAGE = `import { createImageUrlBuilder } from "@sanity/image-url";
+import { dataset, projectId } from "./env";
 
-export const PAGE_QUERY = defineQuery(
-  \`*[_type == "page" && slug.current == $slug][0]{\${PAGE_FIELDS}}\`,
-);
+const builder = createImageUrlBuilder({ projectId, dataset });
 
-export const PAGE_SLUGS_QUERY = defineQuery(
-  \`*[_type == "page" && defined(slug.current) && slug.current != "home"].slug.current\`,
-);
+/** Build a CDN URL for a Sanity image; null when the block has no asset. */
+export function urlFor(source: unknown, width = 1200): string | null {
+  const ref = (source as { asset?: { _ref?: string } } | null)?.asset?._ref;
+  if (!ref) return null;
+  return builder.image(ref).width(width).auto("format").url();
+}
+`, ASTRO_PAGE_BUILDER = `---
+import { urlFor } from "@workspace/sanity/image";
+import type { PAGE_QUERY_RESULT } from "@workspace/sanity/types";
+import { PortableText } from "astro-portabletext";
 
-export const SETTINGS_QUERY = defineQuery(
-  \`*[_type == "settings"][0]{ siteTitle, siteDescription, socialImage }\`,
-);
-`, SEED_NDJSON = `{"_id":"settings","_type":"settings","siteTitle":"Turbo Wizard","siteDescription":"A Turborepo monorepo scaffolded with create-turbo-wizard, with Sanity wired end to end."}
-{"_id":"page-home","_type":"page","title":"Turbo Wizard","description":"The home page, served from Sanity.","slug":{"_type":"slug","current":"home"},"pageBuilder":[{"_key":"hero1","_type":"hero","heading":"Content from Sanity, rendered by your app","subheading":"This page lives in the Studio. Edit it there and watch it change here."},{"_key":"rich1","_type":"richText","heading":"How this fits together","content":[{"_key":"b1","_type":"block","style":"normal","markDefs":[],"children":[{"_key":"s1","_type":"span","marks":[],"text":"The schema lives in apps/web/sanity/schema. Queries live in apps/web/sanity/queries.ts and run through typegen, so results are typed. The page builder renders each block by its _type."}]}]},{"_key":"cta1","_type":"cta","heading":"Open the Studio","text":"Edit this page and reload.","buttonLabel":"Open Studio","buttonHref":"/studio"}]}
-{"_id":"page-about","_type":"page","title":"About","description":"A second page, to show routing by slug.","slug":{"_type":"slug","current":"about"},"pageBuilder":[{"_key":"hero2","_type":"hero","heading":"About this starter","subheading":"Pages are routed by their slug."},{"_key":"rich2","_type":"richText","content":[{"_key":"b2","_type":"block","style":"normal","markDefs":[],"children":[{"_key":"s2","_type":"span","marks":[],"text":"Add a page in the Studio, give it a slug, and it appears at that path."}]}]}]}
-`, NEXT_ENV = `export const projectId = process.env.NEXT_PUBLIC_SANITY_PROJECT_ID || "placeholder";
+// Derived from the generated query result rather than hand-written: the page builder's
+// shape IS what the projection returns, so typegen is the only source that cannot drift.
+type PageBlock = NonNullable<NonNullable<PAGE_QUERY_RESULT>["pageBuilder"]>[number];
+type ButtonLink = NonNullable<Extract<PageBlock, { _type: "hero" }>["buttons"]>[number];
 
-export const dataset = process.env.NEXT_PUBLIC_SANITY_DATASET || "production";
+interface Props {
+  blocks: PageBlock[];
+}
 
-// A recent pinned date, per Sanity's API-versioning guidance (the docs pin the date the
-// project was set up; bump deliberately, never to "today").
-export const apiVersion = process.env.NEXT_PUBLIC_SANITY_API_VERSION || "2026-02-01";
+const { blocks } = Astro.props;
 
-/** Server-only read token; empty when unset (draft mode and live previews need it). */
-export const readToken = process.env.SANITY_API_READ_TOKEN ?? "";
+const section = "margin: 3rem 0;";
+const grid = "display: grid; gap: 1.5rem; grid-template-columns: repeat(auto-fit, minmax(16rem, 1fr));";
+const card = "border: 1px solid #e5e5e5; border-radius: 0.75rem; padding: 1.25rem;";
 
-/** The embedded Studio's route — stega encodes it into every string it returns. */
-export const studioUrl = "/studio";
+const buttonProps = (button: ButtonLink) =>
+  button.openInNewTab ? { target: "_blank", rel: "noreferrer" } : {};
+---
 
-/**
- * False on a freshly scaffolded project. Guards every fetch so the build never dials
+{
+  blocks.map((block) => {
+    if (block._type === "hero") {
+      const src = urlFor(block.image, 1600);
+      return (
+        <section style={section}>
+          {block.badge && <p style="opacity: 0.6; margin: 0;">{block.badge}</p>}
+          <h2>{block.title}</h2>
+          {block.richText && <PortableText value={block.richText} />}
+          {!!block.buttons?.length && (
+            <p style="display: flex; gap: 0.75rem; flex-wrap: wrap;">
+              {block.buttons.map(
+                (button) =>
+                  button.href && (
+                    <a href={button.href} {...buttonProps(button)}>
+                      {button.text ?? button.href}
+                    </a>
+                  ),
+              )}
+            </p>
+          )}
+          {src && <img src={src} alt={block.image?.alt ?? ""} />}
+        </section>
+      );
+    }
+    if (block._type === "richTextBlock") {
+      return (
+        <section style={section}>
+          {block.eyebrow && <p style="opacity: 0.6; margin: 0;">{block.eyebrow}</p>}
+          {block.title && <h2>{block.title}</h2>}
+          {block.richText && <PortableText value={block.richText} />}
+        </section>
+      );
+    }
+    if (block._type === "featureCardsIcon") {
+      return (
+        <section style={section}>
+          {block.eyebrow && <p style="opacity: 0.6; margin: 0;">{block.eyebrow}</p>}
+          {block.title && <h2>{block.title}</h2>}
+          {block.richText && <PortableText value={block.richText} />}
+          <div style={grid}>
+            {(block.cards ?? []).map((item) => (
+              <div style={card}>
+                {/* \`icon\` holds a Lucide icon name; render it with your icon set of choice. */}
+                {item.icon && <p style="opacity: 0.6; margin: 0;">{item.icon}</p>}
+                <h3>{item.title}</h3>
+                {item.richText && <PortableText value={item.richText} />}
+              </div>
+            ))}
+          </div>
+        </section>
+      );
+    }
+    if (block._type === "imageLinkCards") {
+      return (
+        <section style={section}>
+          {block.eyebrow && <p style="opacity: 0.6; margin: 0;">{block.eyebrow}</p>}
+          {block.title && <h2>{block.title}</h2>}
+          {block.richText && <PortableText value={block.richText} />}
+          <div style={grid}>
+            {(block.cards ?? []).map((item) => {
+              const src = urlFor(item.image, 800);
+              return (
+                <div style={card}>
+                  {src && <img src={src} alt={item.image?.alt ?? ""} />}
+                  <h3>
+                    {item.href ? (
+                      <a
+                        href={item.href}
+                        {...(item.openInNewTab ? { target: "_blank", rel: "noreferrer" } : {})}
+                      >
+                        {item.title}
+                      </a>
+                    ) : (
+                      item.title
+                    )}
+                  </h3>
+                  {item.description && <p>{item.description}</p>}
+                </div>
+              );
+            })}
+          </div>
+        </section>
+      );
+    }
+    if (block._type === "faqAccordion") {
+      return (
+        <section style={section}>
+          {block.eyebrow && <p style="opacity: 0.6; margin: 0;">{block.eyebrow}</p>}
+          {block.title && <h2>{block.title}</h2>}
+          {block.subtitle && <p>{block.subtitle}</p>}
+          {(block.faqs ?? []).map((faq) => (
+            <details style="border-top: 1px solid #e5e5e5; padding: 0.75rem 0;">
+              <summary>{faq.title}</summary>
+              {faq.richText && <PortableText value={faq.richText} />}
+            </details>
+          ))}
+        </section>
+      );
+    }
+    if (block._type === "subscribeNewsletter") {
+      // Presentational only: no action, no handler. Wire it to the \`forms\` module's
+      // endpoint (or your own) when you want it to do something.
+      return (
+        <section style={section}>
+          <h2>{block.title}</h2>
+          {block.subTitle && <PortableText value={block.subTitle} />}
+          <form style="display: flex; gap: 0.5rem; flex-wrap: wrap;">
+            <input type="email" name="email" placeholder="you@example.com" required />
+            <button type="submit">Subscribe</button>
+          </form>
+          {block.helperText && <PortableText value={block.helperText} />}
+        </section>
+      );
+    }
+    if (block._type === "cta") {
+      return (
+        <section style={section}>
+          {block.eyebrow && <p style="opacity: 0.6; margin: 0;">{block.eyebrow}</p>}
+          <h2>{block.title}</h2>
+          {block.richText && <PortableText value={block.richText} />}
+          {!!block.buttons?.length && (
+            <p style="display: flex; gap: 0.75rem; flex-wrap: wrap;">
+              {block.buttons.map(
+                (button) =>
+                  button.href && (
+                    <a href={button.href} {...buttonProps(button)}>
+                      {button.text ?? button.href}
+                    </a>
+                  ),
+              )}
+            </p>
+          )}
+        </section>
+      );
+    }
+    return null;
+  })
+}
+`, ASTRO_SLUG_PAGE = `---
+import { VisualEditing } from "@sanity/astro/visual-editing";
+import { visualEditingEnabled } from "@workspace/sanity/env";
+import { loadQuery } from "@workspace/sanity/fetch";
+import { PAGE_QUERY, PAGE_SLUGS_QUERY } from "@workspace/sanity/queries";
+import type { PAGE_QUERY_RESULT } from "@workspace/sanity/types";
+import PageBuilder from "@workspace/sanity-blocks/PageBuilder.astro";
+
+export async function getStaticPaths() {
+  // Returns [] without credentials, so a fresh scaffold builds with no CMS pages.
+  const slugs = await loadQuery<(string | null)[]>(PAGE_SLUGS_QUERY);
+  return (slugs ?? []).filter(Boolean).map((slug) => ({ params: { slug } }));
+}
+
+const page = await loadQuery<PAGE_QUERY_RESULT>(PAGE_QUERY, { slug: Astro.params.slug });
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{page?.title ?? "web"}</title>
+  </head>
+  <body style="font-family: system-ui, sans-serif; padding: 3rem;">
+    <h1>{page?.title}</h1>
+    <PageBuilder blocks={page?.pageBuilder ?? []} />
+    <VisualEditing enabled={visualEditingEnabled} />
+  </body>
+</html>
+`, ASTRO_BLOG_INDEX_PAGE = `---
+import { VisualEditing } from "@sanity/astro/visual-editing";
+import { visualEditingEnabled } from "@workspace/sanity/env";
+import { loadQuery } from "@workspace/sanity/fetch";
+import { urlFor } from "@workspace/sanity/image";
+import { BLOG_INDEX_QUERY } from "@workspace/sanity/queries";
+import type { BLOG_INDEX_QUERY_RESULT } from "@workspace/sanity/types";
+
+const posts = (await loadQuery<BLOG_INDEX_QUERY_RESULT>(BLOG_INDEX_QUERY)) ?? [];
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>Blog</title>
+  </head>
+  <body style="font-family: system-ui, sans-serif; padding: 3rem;">
+    <h1>Blog</h1>
+    {
+      posts.length === 0 && (
+        <p>
+          No posts yet — seed the dataset with <code>pnpm sanity:seed</code> from apps/studio,
+          or write one in the Studio (<code>pnpm dev:studio</code>).
+        </p>
+      )
+    }
+    {
+      posts.map((post) => {
+        const src = urlFor(post.image, 800);
+        const author = post.authors?.[0];
+        return (
+          <article style="border-top: 1px solid #e5e5e5; padding: 1.5rem 0;">
+            {src && <img src={src} alt={post.image?.alt ?? ""} />}
+            <h2>
+              <a href={\`/blog/\${post.slug}\`}>{post.title}</a>
+            </h2>
+            <p style="opacity: 0.6;">
+              {author?.name}
+              {author?.name && post.publishedAt && " · "}
+              {post.publishedAt && <time datetime={post.publishedAt}>{post.publishedAt}</time>}
+            </p>
+            {post.description && <p>{post.description}</p>}
+          </article>
+        );
+      })
+    }
+    <VisualEditing enabled={visualEditingEnabled} />
+  </body>
+</html>
+`, ASTRO_BLOG_POST_PAGE = `---
+import { VisualEditing } from "@sanity/astro/visual-editing";
+import { visualEditingEnabled } from "@workspace/sanity/env";
+import { loadQuery } from "@workspace/sanity/fetch";
+import { urlFor } from "@workspace/sanity/image";
+import { BLOG_QUERY, BLOG_SLUGS_QUERY } from "@workspace/sanity/queries";
+import type { BLOG_QUERY_RESULT } from "@workspace/sanity/types";
+import { PortableText } from "astro-portabletext";
+
+export async function getStaticPaths() {
+  // Returns [] without credentials, so a fresh scaffold builds with no posts.
+  const slugs = await loadQuery<(string | null)[]>(BLOG_SLUGS_QUERY);
+  return (slugs ?? []).filter(Boolean).map((slug) => ({ params: { slug } }));
+}
+
+const post = await loadQuery<BLOG_QUERY_RESULT>(BLOG_QUERY, { slug: Astro.params.slug });
+const src = urlFor(post?.image, 1600);
+const author = post?.authors?.[0];
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>{post?.title ?? "Blog"}</title>
+    {post?.description && <meta name="description" content={post.description} />}
+  </head>
+  <body style="font-family: system-ui, sans-serif; padding: 3rem;">
+    <p><a href="/blog">← Blog</a></p>
+    <h1>{post?.title}</h1>
+    <p style="opacity: 0.6;">
+      {author?.name && (author.position ? \`\${author.name}, \${author.position}\` : author.name)}
+      {author?.name && post?.publishedAt && " · "}
+      {post?.publishedAt && <time datetime={post.publishedAt}>{post.publishedAt}</time>}
+    </p>
+    {src && <img src={src} alt={post?.image?.alt ?? ""} />}
+    {post?.richText && <PortableText value={post.richText} />}
+    <VisualEditing enabled={visualEditingEnabled} />
+  </body>
+</html>
+`, ASTRO_MODULE_REF = '/// <reference types="@sanity/astro/module" />', ASTRO_ENV_LOADER = `// Astro loads .env after this config runs, so pull it in ourselves for the Sanity ids.
+try {
+  process.loadEnvFile(".env");
+} catch {
+  // No .env — the placeholder ids below keep the build working.
+}
+`;
+
+// ../../packages/registry/src/content/sanity/next.ts
+var NEXT_ENV = `export const projectId = process.env.NEXT_PUBLIC_SANITY_PROJECT_ID || "placeholder";
+
+export const dataset = process.env.NEXT_PUBLIC_SANITY_DATASET || "production";
+
+// A recent pinned date, per Sanity's API-versioning guidance (the docs pin the date the
+// project was set up; bump deliberately, never to "today").
+export const apiVersion = process.env.NEXT_PUBLIC_SANITY_API_VERSION || "2026-02-01";
+
+/** Server-only read token; empty when unset (draft mode and live previews need it). */
+export const readToken = process.env.SANITY_API_READ_TOKEN ?? "";
+
+/**
+ * Where the Studio lives — stega encodes it into every string it returns, so a
+ * Visual Editing click-through lands on the right field. Absolute since the Studio
+ * became its own app (\`sanity dev\` defaults to :3333).
+ */
+export const studioUrl = process.env.NEXT_PUBLIC_SANITY_STUDIO_URL || "http://localhost:3333";
+
+/**
+ * False on a freshly scaffolded project. Guards every fetch so the build never dials
  * placeholder.api.sanity.io and dies; pages render an empty state instead.
  */
 export const hasSanityCredentials = projectId !== "placeholder";
@@ -1109,17 +1320,33 @@ export const client = createClient({
   stega: { studioUrl },
 });
 `, NEXT_LIVE = `import { defineLive } from "next-sanity/live";
-import { readToken } from "./env";
+import { hasSanityCredentials, readToken } from "./env";
 import { client } from "./client";
 
 // defineLive gives us live content plus draft-mode reads. The token is passed as
 // undefined rather than "" when unset — an empty string reads as "provided but invalid".
-export const { sanityFetch, SanityLive } = defineLive({
+export const { sanityFetch, SanityLive: LiveComponent } = defineLive({
   client,
   serverToken: readToken || undefined,
   browserToken: readToken || undefined,
 });
-`, NEXT_FETCH = `import type { QueryParams } from "next-sanity";
+
+/**
+ * On a fresh scaffold \`projectId\` is "placeholder", so the live socket dials
+ * placeholder.api.sanity.io and next-sanity retries forever — the dev log fills with
+ * "<SanityLive> is attempting to reconnect" and nothing else is readable. Render
+ * nothing until there are credentials, the same guard \`loadQuery\` applies to reads.
+ */
+export const SanityLive = hasSanityCredentials ? LiveComponent : () => null;
+`, NEXT_FETCH = `/// <reference path="./sanity.types.ts" />
+// ^ \`sanity typegen generate\` writes sanity.types.ts here (see apps/studio/sanity.cli.ts) and
+// its \`declare module "@sanity/client"\` block is what types every query result. Now that
+// the file lives outside apps/web it is no longer swept up by the app's tsconfig include,
+// so this reference is what pulls it into the program — without it every loadQuery result
+// silently degrades to \`unknown\` and the pages stop type-checking. A path reference cannot
+// be elided the way an unused import can. The file ships pre-generated; regenerate it with
+// \`extract\` + \`type\` from apps/studio.
+import type { QueryParams } from "next-sanity";
 import { client } from "./client";
 import { hasSanityCredentials } from "./env";
 import { sanityFetch } from "./live";
@@ -1173,52 +1400,234 @@ export function urlFor(source: unknown, width = 1200): string | null {
   return builder.image(ref).width(width).auto("format").url();
 }
 `, NEXT_PAGE_BUILDER = `import { PortableText, type PortableTextProps } from "@portabletext/react";
+import { urlFor } from "@workspace/sanity/image";
 import Image from "next/image";
-import { urlFor } from "./image";
 
 type SanityImage = { asset?: { _ref?: string } | null; alt?: string | null } | null;
+type Rich = PortableTextProps["value"] | null;
+
+/** queries.ts flattens every \`customUrl\` to an href, so nothing here branches on link type. */
+type ButtonLink = {
+  _key: string;
+  text?: string | null;
+  variant?: string | null;
+  href?: string | null;
+  openInNewTab?: boolean | null;
+};
 
 export type PageBlock =
-  | { _key: string; _type: "hero"; heading?: string; subheading?: string; image?: SanityImage }
-  | { _key: string; _type: "richText"; heading?: string; content?: PortableTextProps["value"] }
+  | {
+      _key: string;
+      _type: "hero";
+      badge?: string | null;
+      title?: string | null;
+      richText?: Rich;
+      image?: SanityImage;
+      buttons?: ButtonLink[] | null;
+    }
+  | {
+      _key: string;
+      _type: "richTextBlock";
+      eyebrow?: string | null;
+      title?: string | null;
+      richText?: Rich;
+    }
+  | {
+      _key: string;
+      _type: "featureCardsIcon";
+      eyebrow?: string | null;
+      title?: string | null;
+      richText?: Rich;
+      cards?:
+        | { _key: string; icon?: string | null; title?: string | null; richText?: Rich }[]
+        | null;
+    }
+  | {
+      _key: string;
+      _type: "imageLinkCards";
+      eyebrow?: string | null;
+      title?: string | null;
+      richText?: Rich;
+      buttons?: ButtonLink[] | null;
+      cards?:
+        | {
+            _key: string;
+            title?: string | null;
+            description?: string | null;
+            image?: SanityImage;
+            href?: string | null;
+            openInNewTab?: boolean | null;
+          }[]
+        | null;
+    }
+  | {
+      _key: string;
+      _type: "faqAccordion";
+      eyebrow?: string | null;
+      title?: string | null;
+      subtitle?: string | null;
+      faqs?: { _id: string; title?: string | null; richText?: Rich }[] | null;
+    }
+  | {
+      _key: string;
+      _type: "subscribeNewsletter";
+      title?: string | null;
+      subTitle?: Rich;
+      helperText?: Rich;
+    }
   | {
       _key: string;
       _type: "cta";
-      heading?: string;
-      text?: string;
-      buttonLabel?: string;
-      buttonHref?: string;
+      eyebrow?: string | null;
+      title?: string | null;
+      richText?: Rich;
+      buttons?: ButtonLink[] | null;
     };
 
+const section = { margin: "3rem 0" } as const;
+const grid = {
+  display: "grid",
+  gap: "1.5rem",
+  gridTemplateColumns: "repeat(auto-fit, minmax(16rem, 1fr))",
+} as const;
+const card = { border: "1px solid #e5e5e5", borderRadius: "0.75rem", padding: "1.25rem" } as const;
+
+function Eyebrow({ children }: { children?: string | null }) {
+  return children ? <p style={{ opacity: 0.6, margin: 0 }}>{children}</p> : null;
+}
+
+function Buttons({ items }: { items?: ButtonLink[] | null }) {
+  if (!items?.length) return null;
+  return (
+    <p style={{ display: "flex", gap: "0.75rem", flexWrap: "wrap" }}>
+      {items.map((button) =>
+        button.href ? (
+          <a
+            key={button._key}
+            href={button.href}
+            {...(button.openInNewTab ? { target: "_blank", rel: "noreferrer" } : {})}
+          >
+            {button.text ?? button.href}
+          </a>
+        ) : null,
+      )}
+    </p>
+  );
+}
+
 function Block({ block }: { block: PageBlock }) {
   switch (block._type) {
     case "hero": {
       const src = urlFor(block.image, 1600);
       return (
-        <section>
-          <h2>{block.heading}</h2>
-          {block.subheading ? <p>{block.subheading}</p> : null}
+        <section style={section}>
+          <Eyebrow>{block.badge}</Eyebrow>
+          <h2>{block.title}</h2>
+          {block.richText ? <PortableText value={block.richText} /> : null}
+          <Buttons items={block.buttons} />
           {src ? (
             <Image src={src} alt={block.image?.alt ?? ""} width={1600} height={900} />
           ) : null}
         </section>
       );
     }
-    case "richText":
+    case "richTextBlock":
+      return (
+        <section style={section}>
+          <Eyebrow>{block.eyebrow}</Eyebrow>
+          {block.title ? <h2>{block.title}</h2> : null}
+          {block.richText ? <PortableText value={block.richText} /> : null}
+        </section>
+      );
+    case "featureCardsIcon":
+      return (
+        <section style={section}>
+          <Eyebrow>{block.eyebrow}</Eyebrow>
+          {block.title ? <h2>{block.title}</h2> : null}
+          {block.richText ? <PortableText value={block.richText} /> : null}
+          <div style={grid}>
+            {(block.cards ?? []).map((item) => (
+              <div key={item._key} style={card}>
+                {/* \`icon\` holds a Lucide icon name; render it with your icon set of choice. */}
+                {item.icon ? <p style={{ opacity: 0.6, margin: 0 }}>{item.icon}</p> : null}
+                <h3>{item.title}</h3>
+                {item.richText ? <PortableText value={item.richText} /> : null}
+              </div>
+            ))}
+          </div>
+        </section>
+      );
+    case "imageLinkCards":
+      return (
+        <section style={section}>
+          <Eyebrow>{block.eyebrow}</Eyebrow>
+          {block.title ? <h2>{block.title}</h2> : null}
+          {block.richText ? <PortableText value={block.richText} /> : null}
+          <div style={grid}>
+            {(block.cards ?? []).map((item) => {
+              const src = urlFor(item.image, 800);
+              return (
+                <div key={item._key} style={card}>
+                  {src ? (
+                    <Image src={src} alt={item.image?.alt ?? ""} width={800} height={450} />
+                  ) : null}
+                  <h3>
+                    {item.href ? (
+                      <a
+                        href={item.href}
+                        {...(item.openInNewTab ? { target: "_blank", rel: "noreferrer" } : {})}
+                      >
+                        {item.title}
+                      </a>
+                    ) : (
+                      item.title
+                    )}
+                  </h3>
+                  {item.description ? <p>{item.description}</p> : null}
+                </div>
+              );
+            })}
+          </div>
+          <Buttons items={block.buttons} />
+        </section>
+      );
+    case "faqAccordion":
+      // <details> is the accordion — it needs no client component and behaves the same
+      // in the Astro build, where this same markup is duplicated.
+      return (
+        <section style={section}>
+          <Eyebrow>{block.eyebrow}</Eyebrow>
+          {block.title ? <h2>{block.title}</h2> : null}
+          {block.subtitle ? <p>{block.subtitle}</p> : null}
+          {(block.faqs ?? []).map((faq) => (
+            <details key={faq._id} style={{ borderTop: "1px solid #e5e5e5", padding: "0.75rem 0" }}>
+              <summary>{faq.title}</summary>
+              {faq.richText ? <PortableText value={faq.richText} /> : null}
+            </details>
+          ))}
+        </section>
+      );
+    case "subscribeNewsletter":
+      // Presentational only: no action, no handler. Wire it to the \`forms\` module's
+      // endpoint (or your own) when you want it to do something.
       return (
-        <section>
-          {block.heading ? <h2>{block.heading}</h2> : null}
-          {block.content ? <PortableText value={block.content} /> : null}
+        <section style={section}>
+          <h2>{block.title}</h2>
+          {block.subTitle ? <PortableText value={block.subTitle} /> : null}
+          <form style={{ display: "flex", gap: "0.5rem", flexWrap: "wrap" }}>
+            <input type="email" name="email" placeholder="you@example.com" required />
+            <button type="submit">Subscribe</button>
+          </form>
+          {block.helperText ? <PortableText value={block.helperText} /> : null}
         </section>
       );
     case "cta":
       return (
-        <section>
-          <h2>{block.heading}</h2>
-          {block.text ? <p>{block.text}</p> : null}
-          {block.buttonHref && block.buttonLabel ? (
-            <a href={block.buttonHref}>{block.buttonLabel}</a>
-          ) : null}
+        <section style={section}>
+          <Eyebrow>{block.eyebrow}</Eyebrow>
+          <h2>{block.title}</h2>
+          {block.richText ? <PortableText value={block.richText} /> : null}
+          <Buttons items={block.buttons} />
         </section>
       );
     default:
@@ -1236,34 +1645,9 @@ export function PageBuilder({ blocks }: { blocks: PageBlock[] }) {
     </>
   );
 }
-`, NEXT_SANITY_CONFIG, NEXT_SANITY_CLI = `import { defineCliConfig } from "sanity/cli";
-
-// Run from apps/web. \`schema extract\` + \`typegen generate\` need no credentials, so the
-// build-time \`prebuild\` hook works on a fresh clone.
-export default defineCliConfig({
-  api: {
-    projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID || "placeholder",
-    dataset: process.env.NEXT_PUBLIC_SANITY_DATASET || "production",
-  },
-  typegen: {
-    path: "./sanity/**/*.{ts,tsx}",
-    schema: "sanity/schema.json",
-    generates: "sanity/sanity.types.ts",
-  },
-});
-`, NEXT_STUDIO_PAGE = `import { NextStudio } from "next-sanity/studio";
-import config from "../../../sanity.config";
-
-export const dynamic = "force-static";
-
-export { metadata, viewport } from "next-sanity/studio";
-
-export default function StudioPage() {
-  return <NextStudio config={config} />;
-}
-`, NEXT_DRAFT_MODE_ROUTE = `import { defineEnableDraftMode } from "next-sanity/draft-mode";
-import { readToken } from "../../../../sanity/env";
-import { client } from "../../../../sanity/client";
+`, NEXT_DRAFT_MODE_ROUTE = `import { client } from "@workspace/sanity/client";
+import { readToken } from "@workspace/sanity/env";
+import { defineEnableDraftMode } from "next-sanity/draft-mode";
 
 export const { GET } = defineEnableDraftMode({
   client: client.withConfig({ token: readToken }),
@@ -1301,10 +1685,10 @@ export function DisableDraftMode() {
     </a>
   );
 }
-`, NEXT_HOME_PAGE = `import type { Metadata } from "next";
-import { loadQuery } from "../sanity/fetch";
-import { PageBuilder, type PageBlock } from "../sanity/page-builder";
-import { HOME_PAGE_QUERY, SETTINGS_QUERY } from "../sanity/queries";
+`, NEXT_HOME_PAGE = `import { loadQuery } from "@workspace/sanity/fetch";
+import { HOME_PAGE_QUERY, SETTINGS_QUERY } from "@workspace/sanity/queries";
+import { PageBuilder, type PageBlock } from "@workspace/sanity-blocks/blocks";
+import type { Metadata } from "next";
 
 // stega: false — encoded metadata would leak invisible characters into <title>.
 export async function generateMetadata(): Promise<Metadata> {
@@ -1324,7 +1708,8 @@ export default async function HomePage() {
         <h1>No content yet</h1>
         <p>
           Set NEXT_PUBLIC_SANITY_PROJECT_ID in apps/web/.env.local, then seed the dataset:
-          <code> pnpm sanity:seed</code> from apps/web. Edit it at <a href="/studio">/studio</a>.
+          <code> pnpm sanity:seed</code> from apps/studio. Edit it in the Studio:
+          <code> pnpm dev:studio</code>.
         </p>
       </main>
     );
@@ -1337,10 +1722,10 @@ export default async function HomePage() {
     </main>
   );
 }
-`, NEXT_SLUG_PAGE = `import { notFound } from "next/navigation";
-import { loadQuery, loadStaticQuery } from "../../sanity/fetch";
-import { PageBuilder, type PageBlock } from "../../sanity/page-builder";
-import { PAGE_QUERY, PAGE_SLUGS_QUERY } from "../../sanity/queries";
+`, NEXT_SLUG_PAGE = `import { loadQuery, loadStaticQuery } from "@workspace/sanity/fetch";
+import { PAGE_QUERY, PAGE_SLUGS_QUERY } from "@workspace/sanity/queries";
+import { PageBuilder, type PageBlock } from "@workspace/sanity-blocks/blocks";
+import { notFound } from "next/navigation";
 
 export async function generateStaticParams() {
   const slugs = await loadStaticQuery(PAGE_SLUGS_QUERY);
@@ -1359,193 +1744,1877 @@ export default async function Page({ params }: { params: Promise<{ slug: string
     </main>
   );
 }
-`, ASTRO_ENV = `export const projectId = import.meta.env.PUBLIC_SANITY_PROJECT_ID || "placeholder";
+`, NEXT_BLOG_INDEX_PAGE = `import { loadQuery } from "@workspace/sanity/fetch";
+import { urlFor } from "@workspace/sanity/image";
+import { BLOG_INDEX_QUERY } from "@workspace/sanity/queries";
+import type { Metadata } from "next";
+import Image from "next/image";
 
-export const dataset = import.meta.env.PUBLIC_SANITY_DATASET || "production";
+export const metadata: Metadata = { title: "Blog" };
 
-/** Server-only read token; required (and only read) when Visual Editing is enabled. */
-export const readToken = import.meta.env.SANITY_API_READ_TOKEN ?? "";
+export default async function BlogIndexPage() {
+  const posts = (await loadQuery(BLOG_INDEX_QUERY)) ?? [];
 
-/**
- * The @sanity/astro Visual Editing switch. Off by default: overlays need a rendering
- * server (\`astro dev\`, or an SSR adapter in production) plus SANITY_API_READ_TOKEN.
- */
-export const visualEditingEnabled =
-  import.meta.env.PUBLIC_SANITY_VISUAL_EDITING_ENABLED === "true";
+  return (
+    <main style={{ fontFamily: "system-ui, sans-serif", padding: "3rem" }}>
+      <h1>Blog</h1>
+      {posts.length === 0 ? (
+        <p>
+          No posts yet — seed the dataset with <code>pnpm sanity:seed</code> from apps/studio,
+          or write one in the Studio (<code>pnpm dev:studio</code>).
+        </p>
+      ) : null}
+      {posts.map((post) => {
+        const src = urlFor(post.image, 800);
+        const author = post.authors?.[0];
+        return (
+          <article key={post._id} style={{ borderTop: "1px solid #e5e5e5", padding: "1.5rem 0" }}>
+            {src ? <Image src={src} alt={post.image?.alt ?? ""} width={800} height={450} /> : null}
+            <h2>
+              <a href={\`/blog/\${post.slug}\`}>{post.title}</a>
+            </h2>
+            <p style={{ opacity: 0.6 }}>
+              {author?.name ? <span>{author.name}</span> : null}
+              {author?.name && post.publishedAt ? " · " : null}
+              {post.publishedAt ? <time dateTime={post.publishedAt}>{post.publishedAt}</time> : null}
+            </p>
+            {post.description ? <p>{post.description}</p> : null}
+          </article>
+        );
+      })}
+    </main>
+  );
+}
+`, NEXT_BLOG_POST_PAGE = `import { PortableText } from "@portabletext/react";
+import { loadQuery, loadStaticQuery } from "@workspace/sanity/fetch";
+import { urlFor } from "@workspace/sanity/image";
+import { BLOG_QUERY, BLOG_SLUGS_QUERY } from "@workspace/sanity/queries";
+import type { Metadata } from "next";
+import Image from "next/image";
+import { notFound } from "next/navigation";
 
-/**
- * False on a freshly scaffolded project. Guards every fetch so \`astro build\` never dials
- * placeholder.api.sanity.io and dies; pages render an empty state instead.
- */
-export const hasSanityCredentials = projectId !== "placeholder";
-`, ASTRO_FETCH = `import { sanityClient } from "sanity:client";
-import { hasSanityCredentials, readToken, visualEditingEnabled } from "./env";
+export async function generateStaticParams() {
+  const slugs = await loadStaticQuery(BLOG_SLUGS_QUERY);
+  return (slugs ?? []).filter((slug): slug is string => Boolean(slug)).map((slug) => ({ slug }));
+}
+
+// stega: false — encoded metadata would leak invisible characters into <title>.
+export async function generateMetadata({
+  params,
+}: {
+  params: Promise<{ slug: string }>;
+}): Promise<Metadata> {
+  const { slug } = await params;
+  const post = await loadQuery(BLOG_QUERY, { slug }, { stega: false });
+  return { title: post?.title ?? "Blog", description: post?.description ?? undefined };
+}
+
+export default async function BlogPostPage({ params }: { params: Promise<{ slug: string }> }) {
+  const { slug } = await params;
+  const post = await loadQuery(BLOG_QUERY, { slug });
+  if (!post) notFound();
+
+  const src = urlFor(post.image, 1600);
+  const author = post.authors?.[0];
+
+  return (
+    <main style={{ fontFamily: "system-ui, sans-serif", padding: "3rem" }}>
+      <p>
+        <a href="/blog">← Blog</a>
+      </p>
+      <h1>{post.title}</h1>
+      <p style={{ opacity: 0.6 }}>
+        {author?.name ? <span>{author.position ? \`\${author.name}, \${author.position}\` : author.name}</span> : null}
+        {author?.name && post.publishedAt ? " · " : null}
+        {post.publishedAt ? <time dateTime={post.publishedAt}>{post.publishedAt}</time> : null}
+      </p>
+      {src ? <Image src={src} alt={post.image?.alt ?? ""} width={1600} height={900} /> : null}
+      {post.richText ? <PortableText value={post.richText} /> : null}
+    </main>
+  );
+}
+`;
+
+// ../../packages/registry/src/content/sanity/schema.ts
+var SCHEMA_DEFINITIONS = `import { defineArrayMember, defineField, defineType } from "sanity";
 
 /**
- * The single read path, following @sanity/astro's Visual Editing recipe: with
- * PUBLIC_SANITY_VISUAL_EDITING_ENABLED=true it fetches the drafts perspective with
- * stega source maps, which is what gives Presentation its click-to-edit overlays.
- *
- * Without credentials it returns null before touching the network, so \`astro build\`
- * succeeds on a fresh scaffold. The catch covers a configured-but-unreachable dataset
- * for the same reason: a starter should render empty, not crash.
+ * A link that resolves to either an internal document or an external URL. Blocks store the
+ * choice; queries.ts turns it into a plain \`href\` string so components never branch on it.
+ */
+export const customUrl = defineType({
+  name: "customUrl",
+  title: "URL",
+  type: "object",
+  fields: [
+    defineField({
+      name: "type",
+      type: "string",
+      initialValue: () => "external",
+      options: { list: ["internal", "external"], layout: "radio", direction: "horizontal" },
+      validation: (rule) => rule.required(),
+    }),
+    defineField({
+      name: "openInNewTab",
+      title: "Open in new tab",
+      type: "boolean",
+      initialValue: () => false,
+    }),
+    defineField({
+      name: "external",
+      title: "URL",
+      type: "string",
+      description: "A full address (https://…) or a path (/about).",
+      hidden: ({ parent }) => parent?.type !== "external",
+      validation: (rule) =>
+        rule.custom((value, { parent }) =>
+          (parent as { type?: string })?.type === "external" && !value
+            ? "URL can't be empty"
+            : true,
+        ),
+    }),
+    defineField({
+      name: "internal",
+      type: "reference",
+      to: [{ type: "page" }, { type: "blog" }],
+      options: { disableNew: true },
+      hidden: ({ parent }) => parent?.type !== "internal",
+      validation: (rule) =>
+        rule.custom((value, { parent }) =>
+          (parent as { type?: string })?.type === "internal" && !value?._ref
+            ? "Pick a document to link to"
+            : true,
+        ),
+    }),
+  ],
+  preview: {
+    select: { type: "type", external: "external", internal: "internal.slug.current" },
+    prepare: ({ type, external, internal }) => ({
+      title: type === "external" ? "External link" : "Internal link",
+      subtitle: type === "external" ? external : internal,
+    }),
+  },
+});
+
+export const button = defineType({
+  name: "button",
+  title: "Button",
+  type: "object",
+  fields: [
+    defineField({
+      name: "variant",
+      type: "string",
+      initialValue: () => "default",
+      options: {
+        list: ["default", "secondary", "outline", "link"],
+        layout: "radio",
+        direction: "horizontal",
+      },
+    }),
+    defineField({ name: "text", title: "Button text", type: "string" }),
+    defineField({ name: "url", title: "URL", type: "customUrl" }),
+  ],
+  preview: {
+    select: { title: "text", variant: "variant" },
+    prepare: ({ title, variant }) => ({
+      title: title ?? "Untitled button",
+      subtitle: variant ?? "default",
+    }),
+  },
+});
+
+/**
+ * Portable Text. Registered as a named type so documents and blocks can say
+ * \`type: "richText"\` — the same indirection the reference uses.
+ */
+export const richText = defineType({
+  name: "richText",
+  type: "array",
+  of: [
+    defineArrayMember({
+      name: "block",
+      type: "block",
+      styles: [
+        { title: "Normal", value: "normal" },
+        { title: "H2", value: "h2" },
+        { title: "H3", value: "h3" },
+        { title: "H4", value: "h4" },
+      ],
+      lists: [
+        { title: "Bullet", value: "bullet" },
+        { title: "Numbered", value: "number" },
+      ],
+      marks: {
+        decorators: [
+          { title: "Strong", value: "strong" },
+          { title: "Emphasis", value: "em" },
+          { title: "Code", value: "code" },
+        ],
+        annotations: [
+          {
+            name: "customLink",
+            title: "Link",
+            type: "object",
+            fields: [defineField({ name: "customLink", type: "customUrl" })],
+          },
+        ],
+      },
+    }),
+    defineArrayMember({
+      name: "image",
+      title: "Image",
+      type: "image",
+      options: { hotspot: true },
+      fields: [defineField({ name: "caption", title: "Caption", type: "string" })],
+    }),
+  ],
+});
+`, SCHEMA_BLOCKS = `import { defineArrayMember, defineField, defineType } from "sanity";
+
+// Page-builder blocks are objects, not documents: they only exist inside a page.
+// Field names match turbo-start-sanity's, so its components drop in unchanged.
+
+const imageField = defineField({
+  name: "image",
+  type: "image",
+  options: { hotspot: true },
+  fields: [
+    defineField({
+      name: "alt",
+      title: "Alt text",
+      type: "string",
+      validation: (rule) =>
+        rule.custom((value, context) =>
+          (context.parent as { asset?: unknown })?.asset && !value?.trim()
+            ? "Alt text is required when an image is set"
+            : true,
+        ),
+    }),
+  ],
+});
+
+const buttonsField = defineField({
+  name: "buttons",
+  type: "array",
+  of: [defineArrayMember({ type: "button" })],
+});
+
+export const hero = defineType({
+  name: "hero",
+  title: "Hero",
+  type: "object",
+  fields: [
+    defineField({ name: "badge", type: "string" }),
+    defineField({ name: "title", type: "string" }),
+    defineField({ name: "richText", type: "richText" }),
+    imageField,
+    buttonsField,
+  ],
+  preview: {
+    select: { title: "title", media: "image" },
+    prepare: ({ title, media }) => ({ title: title ?? "Hero", subtitle: "Hero", media }),
+  },
+});
+
+export const cta = defineType({
+  name: "cta",
+  title: "Call to action",
+  type: "object",
+  fields: [
+    defineField({ name: "eyebrow", type: "string" }),
+    defineField({ name: "title", type: "string" }),
+    defineField({ name: "richText", type: "richText" }),
+    buttonsField,
+  ],
+  preview: {
+    select: { title: "title" },
+    prepare: ({ title }) => ({ title: title ?? "Call to action", subtitle: "CTA" }),
+  },
+});
+
+export const richTextBlock = defineType({
+  name: "richTextBlock",
+  title: "Rich text",
+  type: "object",
+  fields: [
+    defineField({ name: "eyebrow", type: "string" }),
+    defineField({ name: "title", type: "string" }),
+    defineField({ name: "richText", type: "richText" }),
+  ],
+  preview: {
+    select: { title: "title" },
+    prepare: ({ title }) => ({ title: title ?? "Rich text", subtitle: "Rich text" }),
+  },
+});
+
+// The reference stores \`icon\` as a \`lucide-icon\`, a custom input from
+// sanity-plugin-lucide-icon-picker. A plain string keeps the field (and the GROQ) the same
+// shape without a Studio plugin — add the plugin later and only this field changes.
+const featureCardIcon = defineArrayMember({
+  name: "featureCardIcon",
+  type: "object",
+  fields: [
+    defineField({
+      name: "icon",
+      type: "string",
+      description: 'A Lucide icon name, e.g. "zap" or "shield-check".',
+    }),
+    defineField({ name: "title", type: "string" }),
+    defineField({ name: "richText", type: "richText" }),
+  ],
+  preview: { select: { title: "title", subtitle: "icon" } },
+});
+
+export const featureCardsIcon = defineType({
+  name: "featureCardsIcon",
+  title: "Feature cards",
+  type: "object",
+  fields: [
+    defineField({ name: "eyebrow", type: "string" }),
+    defineField({ name: "title", type: "string" }),
+    defineField({ name: "richText", type: "richText" }),
+    defineField({ name: "cards", type: "array", of: [featureCardIcon] }),
+  ],
+  preview: {
+    select: { title: "title", cards: "cards" },
+    prepare: ({ title, cards }) => ({
+      title: title ?? "Feature cards",
+      subtitle: \`\${cards?.length ?? 0} cards\`,
+    }),
+  },
+});
+
+const imageLinkCard = defineArrayMember({
+  name: "imageLinkCard",
+  type: "object",
+  fields: [
+    defineField({ name: "title", type: "string", validation: (rule) => rule.required() }),
+    defineField({ name: "description", type: "text", rows: 2 }),
+    imageField,
+    defineField({ name: "url", title: "Link", type: "customUrl" }),
+  ],
+  preview: { select: { title: "title", subtitle: "description", media: "image" } },
+});
+
+export const imageLinkCards = defineType({
+  name: "imageLinkCards",
+  title: "Image link cards",
+  type: "object",
+  fields: [
+    defineField({ name: "eyebrow", type: "string" }),
+    defineField({ name: "title", type: "string", validation: (rule) => rule.required() }),
+    defineField({ name: "richText", type: "richText" }),
+    buttonsField,
+    defineField({ name: "cards", type: "array", of: [imageLinkCard] }),
+  ],
+  preview: {
+    select: { title: "title", cards: "cards" },
+    prepare: ({ title, cards }) => ({
+      title: title ?? "Image link cards",
+      subtitle: \`\${cards?.length ?? 0} cards\`,
+    }),
+  },
+});
+
+export const faqAccordion = defineType({
+  name: "faqAccordion",
+  title: "FAQ accordion",
+  type: "object",
+  fields: [
+    defineField({ name: "eyebrow", type: "string" }),
+    defineField({ name: "title", type: "string", validation: (rule) => rule.required() }),
+    defineField({ name: "subtitle", type: "string" }),
+    defineField({
+      name: "faqs",
+      title: "FAQs",
+      type: "array",
+      of: [defineArrayMember({ type: "reference", to: [{ type: "faq" }] })],
+      validation: (rule) => rule.unique(),
+    }),
+  ],
+  preview: {
+    select: { title: "title", faqs: "faqs" },
+    prepare: ({ title, faqs }) => ({
+      title: title ?? "FAQ accordion",
+      subtitle: \`\${faqs?.length ?? 0} questions\`,
+    }),
+  },
+});
+
+export const subscribeNewsletter = defineType({
+  name: "subscribeNewsletter",
+  title: "Subscribe newsletter",
+  type: "object",
+  fields: [
+    defineField({ name: "title", type: "string" }),
+    defineField({ name: "subTitle", title: "Subtitle", type: "richText" }),
+    defineField({ name: "helperText", title: "Helper text", type: "richText" }),
+  ],
+  preview: {
+    select: { title: "title" },
+    prepare: ({ title }) => ({ title: title ?? "Newsletter", subtitle: "Newsletter" }),
+  },
+});
+
+/**
+ * Every page-builder block, in the order the \`page\` document offers them. The Studio
+ * imports this and composes it with its own document schemas — one list to keep in step
+ * with the renderers that live beside it, instead of two.
+ */
+export const blockSchemas = [
+  hero,
+  richTextBlock,
+  featureCardsIcon,
+  imageLinkCards,
+  faqAccordion,
+  subscribeNewsletter,
+  cta,
+];
+`, SCHEMA_PAGE = `import { defineArrayMember, defineField, defineType } from "sanity";
+
+export const page = defineType({
+  name: "page",
+  title: "Page",
+  type: "document",
+  fields: [
+    defineField({ name: "title", type: "string", validation: (rule) => rule.required() }),
+    defineField({
+      name: "slug",
+      type: "slug",
+      options: { source: "title" },
+      validation: (rule) => rule.required(),
+    }),
+    defineField({ name: "description", type: "text", rows: 3 }),
+    defineField({ name: "image", type: "image", options: { hotspot: true } }),
+    defineField({
+      name: "pageBuilder",
+      title: "Page builder",
+      type: "array",
+      of: [
+        defineArrayMember({ type: "hero" }),
+        defineArrayMember({ type: "richTextBlock" }),
+        defineArrayMember({ type: "featureCardsIcon" }),
+        defineArrayMember({ type: "imageLinkCards" }),
+        defineArrayMember({ type: "faqAccordion" }),
+        defineArrayMember({ type: "subscribeNewsletter" }),
+        defineArrayMember({ type: "cta" }),
+      ],
+    }),
+  ],
+  // The home page is the \`page\` whose slug is "home" — see sanity/queries.ts.
+  preview: { select: { title: "title", subtitle: "slug.current", media: "image" } },
+});
+`, SCHEMA_BLOG = `import { defineArrayMember, defineField, defineType } from "sanity";
+
+export const author = defineType({
+  name: "author",
+  title: "Author",
+  type: "document",
+  fields: [
+    defineField({ name: "name", type: "string", validation: (rule) => rule.required() }),
+    defineField({ name: "position", type: "string" }),
+    defineField({ name: "image", type: "image", options: { hotspot: true } }),
+    defineField({ name: "bio", type: "text", rows: 3 }),
+  ],
+  preview: { select: { title: "name", subtitle: "position", media: "image" } },
+});
+
+export const blog = defineType({
+  name: "blog",
+  title: "Blog post",
+  type: "document",
+  fields: [
+    defineField({ name: "title", type: "string", validation: (rule) => rule.required() }),
+    defineField({
+      name: "slug",
+      type: "slug",
+      options: { source: "title" },
+      validation: (rule) => rule.required(),
+    }),
+    defineField({ name: "description", type: "text", rows: 3 }),
+    defineField({
+      name: "authors",
+      type: "array",
+      of: [
+        defineArrayMember({
+          type: "reference",
+          to: [{ type: "author" }],
+          options: { disableNew: true },
+        }),
+      ],
+      validation: (rule) => rule.unique().max(1),
+    }),
+    defineField({
+      name: "publishedAt",
+      title: "Published at",
+      type: "date",
+      // slice, not split("T")[0] — under noUncheckedIndexedAccess the index gives
+      // \`string | undefined\` and initialValue will not take it.
+      initialValue: () => new Date().toISOString().slice(0, 10),
+    }),
+    // Optional, unlike the reference's required image: seeded posts ship without image
+    // assets, and the renderers have to handle a post with no image regardless.
+    defineField({
+      name: "image",
+      type: "image",
+      options: { hotspot: true },
+      fields: [defineField({ name: "alt", title: "Alt text", type: "string" })],
+    }),
+    defineField({ name: "richText", title: "Content", type: "richText" }),
+  ],
+  preview: {
+    select: { title: "title", author: "authors.0.name", date: "publishedAt", media: "image" },
+    prepare: ({ title, author, date, media }) => ({
+      title: title ?? "Untitled post",
+      subtitle: [author, date].filter(Boolean).join(" · "),
+      media,
+    }),
+  },
+});
+
+export const faq = defineType({
+  name: "faq",
+  title: "FAQ",
+  type: "document",
+  fields: [
+    defineField({
+      name: "title",
+      title: "Question",
+      type: "string",
+      validation: (rule) => rule.required(),
+    }),
+    defineField({ name: "richText", title: "Answer", type: "richText" }),
+  ],
+  preview: { select: { title: "title" } },
+});
+`, SCHEMA_SETTINGS = `import { defineField, defineType } from "sanity";
+
+export const settings = defineType({
+  name: "settings",
+  title: "Settings",
+  type: "document",
+  fields: [
+    defineField({ name: "siteTitle", type: "string", validation: (rule) => rule.required() }),
+    defineField({ name: "siteDescription", type: "text", rows: 3 }),
+    defineField({
+      name: "socialImage",
+      title: "Social share image",
+      type: "image",
+      options: { hotspot: true },
+    }),
+  ],
+  preview: { select: { title: "siteTitle", media: "socialImage" } },
+});
+`, SCHEMA_INDEX = `import { blockSchemas } from "@workspace/sanity-blocks";
+import type { SchemaTypeDefinition } from "sanity";
+import { author, blog, faq } from "./blog";
+import { button, customUrl, richText } from "./definitions";
+import { page } from "./page";
+import { settings } from "./settings";
+
+export const schemaTypes: SchemaTypeDefinition[] = [
+  // Documents
+  page,
+  blog,
+  author,
+  faq,
+  settings,
+  // Reusable definitions
+  customUrl,
+  button,
+  richText,
+  // Page-builder blocks — declared in @workspace/sanity-blocks, next to their renderers.
+  ...blockSchemas,
+];
+`, STRUCTURE = `import type { StructureResolver } from "sanity/structure";
+
+/**
+ * \`settings\` is a singleton: one document with a fixed id, edited in place instead of
+ * listed. Everything else falls through to the default document-type lists.
+ *
+ * The two sets feed sanity.config.ts's \`document.newDocumentOptions\` / \`document.actions\`
+ * guards (the official singleton recipe), so a second settings document cannot be created.
+ */
+export const singletonTypes = new Set(["settings"]);
+
+/** Actions that keep a singleton editable without allowing create/delete/duplicate. */
+export const singletonActions = new Set(["publish", "discardChanges", "restore"]);
+
+export const structure: StructureResolver = (S) =>
+  S.list()
+    .title("Content")
+    .items([
+      S.listItem()
+        .title("Settings")
+        .id("settings")
+        .child(S.document().schemaType("settings").documentId("settings")),
+      S.divider(),
+      S.documentTypeListItem("page").title("Pages"),
+      S.documentTypeListItem("blog").title("Blog posts"),
+      S.documentTypeListItem("author").title("Authors"),
+      S.documentTypeListItem("faq").title("FAQs"),
+    ]);
+`, PRESENTATION = `import { defineDocuments, defineLocations } from "sanity/presentation";
+
+/** Route → document: lets Presentation open the right document for the URL in the iframe. */
+export const mainDocuments = defineDocuments([
+  { route: "/", filter: \`_type == "page" && slug.current == "home"\` },
+  { route: "/blog/:slug", filter: \`_type == "blog" && slug.current == $slug\` },
+  { route: "/:slug", filter: \`_type == "page" && slug.current == $slug\` },
+]);
+
+/** Document → routes: the "Used on …" links shown when editing a document. */
+export const locations = {
+  settings: defineLocations({
+    locations: [{ title: "Home", href: "/" }],
+    message: "This document is used on all pages",
+    tone: "positive",
+  }),
+  page: defineLocations({
+    select: { title: "title", slug: "slug.current" },
+    resolve: (doc) => ({
+      locations: [
+        {
+          title: doc?.title || "Untitled",
+          href: doc?.slug === "home" ? "/" : \`/\${doc?.slug}\`,
+        },
+      ],
+    }),
+  }),
+  blog: defineLocations({
+    select: { title: "title", slug: "slug.current" },
+    resolve: (doc) => ({
+      locations: [
+        { title: doc?.title || "Untitled", href: \`/blog/\${doc?.slug}\` },
+        { title: "Blog", href: "/blog" },
+      ],
+    }),
+  }),
+};
+`, DOCUMENT_GUARD = `  document: {
+    newDocumentOptions: (prev, { creationContext }) =>
+      creationContext.type === "global"
+        ? prev.filter((template) => !singletonTypes.has(template.templateId))
+        : prev,
+    actions: (prev, { schemaType }) =>
+      singletonTypes.has(schemaType)
+        ? prev.filter(({ action }) => action && singletonActions.has(action))
+        : prev,
+  },`, QUERIES = `import { defineQuery } from "groq";
+
+/**
+ * A \`customUrl\` collapsed to a plain href, so components never branch on internal vs
+ * external. Written against a field literally named \`url\` — the shape \`button\` and
+ * \`imageLinkCard\` both use.
+ */
+const LINK_FIELDS = /* groq */ \`
+  "openInNewTab": url.openInNewTab,
+  "href": select(
+    url.type == "external" => url.external,
+    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,
+    url.internal->slug.current == "home" => "/",
+    defined(url.internal->slug.current) => "/" + url.internal->slug.current,
+    "#"
+  )
+\`;
+
+const BUTTONS = /* groq */ \`buttons[]{ _key, _type, text, variant, \${LINK_FIELDS} }\`;
+
+// \`...\` first, then the overrides: every block keeps its plain fields, and the two that
+// hold references or links get resolved on top.
+const PAGE_BUILDER = /* groq */ \`
+  pageBuilder[]{
+    ...,
+    \${BUTTONS},
+    _type == "faqAccordion" => { faqs[]->{ _id, title, richText } },
+    _type == "imageLinkCards" => { cards[]{ ..., \${LINK_FIELDS} } }
+  }
+\`;
+
+const PAGE_FIELDS = /* groq */ \`
+  _id,
+  _type,
+  title,
+  description,
+  "slug": slug.current,
+  \${PAGE_BUILDER}
+\`;
+
+const BLOG_CARD_FIELDS = /* groq */ \`
+  _id,
+  title,
+  description,
+  publishedAt,
+  image,
+  "slug": slug.current,
+  "authors": authors[]->{ _id, name, position, image }
+\`;
+
+export const HOME_PAGE_QUERY = defineQuery(
+  \`*[_type == "page" && slug.current == "home"][0]{\${PAGE_FIELDS}}\`,
+);
+
+export const PAGE_QUERY = defineQuery(
+  \`*[_type == "page" && slug.current == $slug][0]{\${PAGE_FIELDS}}\`,
+);
+
+export const PAGE_SLUGS_QUERY = defineQuery(
+  \`*[_type == "page" && defined(slug.current) && slug.current != "home"].slug.current\`,
+);
+
+export const BLOG_INDEX_QUERY = defineQuery(
+  \`*[_type == "blog" && defined(slug.current)]|order(publishedAt desc){\${BLOG_CARD_FIELDS}}\`,
+);
+
+export const BLOG_QUERY = defineQuery(
+  \`*[_type == "blog" && slug.current == $slug][0]{\${BLOG_CARD_FIELDS}, richText}\`,
+);
+
+export const BLOG_SLUGS_QUERY = defineQuery(
+  \`*[_type == "blog" && defined(slug.current)].slug.current\`,
+);
+
+export const SETTINGS_QUERY = defineQuery(
+  \`*[_type == "settings"][0]{ siteTitle, siteDescription, socialImage }\`,
+);
+`;
+
+// ../../packages/registry/src/content/sanity/seed.ts
+var para = (key, text) => ({
+  _key: key,
+  _type: "block",
+  style: "normal",
+  markDefs: [],
+  children: [{ _key: `${key}s`, _type: "span", marks: [], text }]
+}), internal = (id) => ({
+  _type: "customUrl",
+  type: "internal",
+  openInNewTab: false,
+  internal: { _type: "reference", _ref: id }
+}), external = (href) => ({
+  _type: "customUrl",
+  type: "external",
+  openInNewTab: true,
+  external: href
+}), button = (key, text, url, variant = "default") => ({
+  _key: key,
+  _type: "button",
+  text,
+  variant,
+  url
+}), DOCS, SEED_NDJSON;
+var init_seed = __esm(() => {
+  DOCS = [
+    {
+      _id: "settings",
+      _type: "settings",
+      siteTitle: "Turbo Wizard",
+      siteDescription: "A Turborepo monorepo scaffolded with create-turbo-wizard, with Sanity wired end to end."
+    },
+    {
+      _id: "author-nova",
+      _type: "author",
+      name: "Nova Lang",
+      position: "Staff engineer",
+      bio: "Writes about build systems and the parts of a monorepo nobody reads until they break."
+    },
+    {
+      _id: "author-atlas",
+      _type: "author",
+      name: "Atlas Reyes",
+      position: "Content lead",
+      bio: "Turns a schema into something an editor can actually use."
+    },
+    {
+      _id: "faq-content",
+      _type: "faq",
+      title: "Where does this content live?",
+      richText: [
+        para("a1", "In your Sanity dataset. The document schemas are in apps/studio/schemaTypes, the queries are in packages/sanity/src/queries.ts, and the Studio edits what they describe.")
+      ]
+    },
+    {
+      _id: "faq-blocks",
+      _type: "faq",
+      title: "How do I add a page-builder block?",
+      richText: [
+        para("a2", "Define it in packages/sanity-blocks/src/schema.ts, add it to the page document's pageBuilder array, then render it in the page-builder component beside it. Three files, no engine changes.")
+      ]
+    },
+    {
+      _id: "faq-credentials",
+      _type: "faq",
+      title: "What happens without a project id?",
+      richText: [
+        para("a3", "Every read short-circuits and the site renders an empty state. The build never dials the API, so a fresh scaffold ships green before anyone signs up for anything.")
+      ]
+    },
+    {
+      _id: "page-home",
+      _type: "page",
+      title: "Turbo Wizard",
+      description: "The home page, served from Sanity.",
+      slug: { _type: "slug", current: "home" },
+      pageBuilder: [
+        {
+          _key: "hero",
+          _type: "hero",
+          badge: "Scaffolded",
+          title: "Content from Sanity, rendered by your app",
+          richText: [
+            para("h1", "This page lives in the Studio. Edit it there and it changes here — every block below came out of the same dataset.")
+          ],
+          buttons: [
+            button("hb1", "Read the blog", internal("blog-page-builder")),
+            button("hb2", "Sanity docs", external("https://www.sanity.io/docs"), "outline")
+          ]
+        },
+        {
+          _key: "features",
+          _type: "featureCardsIcon",
+          eyebrow: "What you got",
+          title: "Wired end to end",
+          cards: [
+            {
+              _key: "f1",
+              _type: "featureCardIcon",
+              icon: "layers",
+              title: "Page builder",
+              richText: [para("f1a", "Seven block types, composed per page in the Studio.")]
+            },
+            {
+              _key: "f2",
+              _type: "featureCardIcon",
+              icon: "pen-line",
+              title: "Blog",
+              richText: [para("f2a", "Posts with authors, dates and Portable Text bodies.")]
+            },
+            {
+              _key: "f3",
+              _type: "featureCardIcon",
+              icon: "shield-check",
+              title: "Typed queries",
+              richText: [para("f3a", "defineQuery plus typegen, so results are not any.")]
+            }
+          ]
+        },
+        {
+          _key: "cards",
+          _type: "imageLinkCards",
+          eyebrow: "Go deeper",
+          title: "Where to look next",
+          cards: [
+            {
+              _key: "c1",
+              _type: "imageLinkCard",
+              title: "The schema",
+              description: "Documents, blocks and the reusable definitions they share.",
+              url: external("https://www.sanity.io/docs/schema-types")
+            },
+            {
+              _key: "c2",
+              _type: "imageLinkCard",
+              title: "About this starter",
+              description: "A second page, routed by its slug.",
+              url: internal("page-about")
+            }
+          ]
+        },
+        {
+          _key: "faqs",
+          _type: "faqAccordion",
+          eyebrow: "Questions",
+          title: "The ones that come up first",
+          faqs: [
+            { _key: "q1", _type: "reference", _ref: "faq-content" },
+            { _key: "q2", _type: "reference", _ref: "faq-blocks" },
+            { _key: "q3", _type: "reference", _ref: "faq-credentials" }
+          ]
+        },
+        {
+          _key: "prose",
+          _type: "richTextBlock",
+          eyebrow: "How it fits together",
+          title: "One schema, two frontends",
+          richText: [
+            para("p1", "The schema and the GROQ are frontend-agnostic — the same files ship whether you picked Next or Astro. Only the rendering layer differs."),
+            para("p2", "The page builder renders each block by its _type and skips anything it does not recognise, so adding a block to the schema never breaks a deployed page.")
+          ]
+        },
+        {
+          _key: "newsletter",
+          _type: "subscribeNewsletter",
+          title: "Ship notes",
+          subTitle: [para("n1", "Occasional posts about the stack this project scaffolds.")],
+          helperText: [para("n2", "No spam. The form is a stub until you wire it up.")]
+        },
+        {
+          _key: "cta",
+          _type: "cta",
+          eyebrow: "Your turn",
+          title: "Open the Studio",
+          richText: [
+            para("ct1", "Edit this page in the Studio — pnpm dev:studio — then publish and reload.")
+          ],
+          buttons: [button("cb1", "Read the blog", internal("blog-typed-groq"))]
+        }
+      ]
+    },
+    {
+      _id: "page-about",
+      _type: "page",
+      title: "About",
+      description: "A second page, to show routing by slug.",
+      slug: { _type: "slug", current: "about" },
+      pageBuilder: [
+        {
+          _key: "hero",
+          _type: "hero",
+          title: "About this starter",
+          richText: [para("ab1", "Pages are routed by their slug. This one is /about.")]
+        },
+        {
+          _key: "prose",
+          _type: "richTextBlock",
+          title: "Add your own",
+          richText: [
+            para("ab2", "Create a page in the Studio, give it a slug, publish it, and it appears at that path on the next build.")
+          ]
+        }
+      ]
+    },
+    {
+      _id: "blog-page-builder",
+      _type: "blog",
+      title: "A page builder is just an array",
+      description: "The page-builder pattern in one sentence: a document holds an array of objects, and the frontend renders each one by its _type.",
+      slug: { _type: "slug", current: "a-page-builder-is-just-an-array" },
+      publishedAt: "2026-01-14",
+      authors: [{ _key: "a1", _type: "reference", _ref: "author-nova" }],
+      richText: [
+        para("b1", "Every block in this starter is a Sanity object type. The page document holds them in an ordered array, and the renderer switches on _type — unknown types are skipped rather than thrown on, so a schema change can never take down a live page."),
+        para("b2", "The interesting consequence is that adding a block is a schema edit plus a component, with no routing and no migration. Editors compose; developers supply the vocabulary.")
+      ]
+    },
+    {
+      _id: "blog-typed-groq",
+      _type: "blog",
+      title: "Typed GROQ, without hand-writing types",
+      description: "defineQuery marks a string as a query, sanity typegen reads the schema, and query results stop being any.",
+      slug: { _type: "slug", current: "typed-groq" },
+      publishedAt: "2026-01-28",
+      authors: [{ _key: "a1", _type: "reference", _ref: "author-nova" }],
+      richText: [
+        para("b1", "Wrapping a query in defineQuery is what makes it visible to typegen. A plain template literal looks like any other string and its result stays any, which is the failure mode you notice three refactors later."),
+        para("b2", "This project commits the generated types, so a fresh clone type-checks before anything runs; re-run extract and typegen generate from apps/studio after a schema or query edit.")
+      ]
+    },
+    {
+      _id: "blog-editors",
+      _type: "blog",
+      title: "Write the schema for the person editing it",
+      description: "Field descriptions, previews and singletons are not polish. They are the difference between a Studio someone uses and one they avoid.",
+      slug: { _type: "slug", current: "write-the-schema-for-the-editor" },
+      publishedAt: "2026-02-09",
+      authors: [{ _key: "a1", _type: "reference", _ref: "author-atlas" }],
+      richText: [
+        para("b1", "A document list showing three rows of Untitled is a schema that forgot it has users. Previews take a prepare function; use it to show the slug, the author, the publish date — whatever tells one row from another."),
+        para("b2", "The same goes for singletons. Settings should be one document you open, not a list you can accidentally add a second row to.")
+      ]
+    }
+  ];
+  SEED_NDJSON = `${DOCS.map((doc) => JSON.stringify(doc)).join(`
+`)}
+`;
+});
+
+// ../../packages/registry/src/content/sanity/studio.ts
+var j5 = (value) => `${JSON.stringify(value, null, 2)}
+`, STUDIO_PACKAGE_JSON, STUDIO_TSCONFIG, NEXT_SITE_URL = "http://localhost:3000", ASTRO_SITE_URL = "http://localhost:4321", studioEnvExample = (siteUrl) => `# Copy to apps/studio/.env, then fill in the project id.
+# A Studio only reads SANITY_STUDIO_*-prefixed variables.
+SANITY_STUDIO_PROJECT_ID=
+SANITY_STUDIO_DATASET=
+# Where Presentation points its preview iframe (the site, not the Studio).
+SANITY_STUDIO_PRESENTATION_URL=${siteUrl}
+`, STUDIO_ENV_EXAMPLE_NEXT, STUDIO_ENV_EXAMPLE_ASTRO, STUDIO_CLI = `import { defineCliConfig } from "sanity/cli";
+
+export default defineCliConfig({
+  api: {
+    projectId: process.env.SANITY_STUDIO_PROJECT_ID || "placeholder",
+    dataset: process.env.SANITY_STUDIO_DATASET || "production",
+  },
+  // The Studio owns extraction and typegen — the CLI has to run where sanity.config.ts
+  // lives — but the generated types land beside the queries they type, in
+  // @workspace/sanity. Paths are relative to apps/studio; \`schema\` defaults to the
+  // schema.json that \`sanity schema extract\` writes here.
+  typegen: {
+    path: "../../packages/sanity/src/**/*.{ts,tsx}",
+    generates: "../../packages/sanity/src/sanity.types.ts",
+  },
+});
+`, studioConfig = (siteUrl, previewMode) => `import { defineConfig } from "sanity";
+import { presentationTool } from "sanity/presentation";
+import { structureTool } from "sanity/structure";
+import { locations, mainDocuments } from "./presentation";
+import { schemaTypes } from "./schemaTypes/index";
+import { singletonActions, singletonTypes, structure } from "./structure";
+
+export default defineConfig({
+  name: "default",
+  title: "Studio",
+  projectId: process.env.SANITY_STUDIO_PROJECT_ID || "placeholder",
+  dataset: process.env.SANITY_STUDIO_DATASET || "production",
+  plugins: [
+    presentationTool({
+      resolve: { mainDocuments, locations },
+      previewUrl: {
+        // Absolute, unlike an embedded Studio's "/": the site is a different origin now.
+        initial: process.env.SANITY_STUDIO_PRESENTATION_URL || "${siteUrl}",${previewMode}
+      },
+    }),
+    structureTool({ structure }),
+  ],
+  schema: { types: schemaTypes },
+${DOCUMENT_GUARD}
+});
+`, STUDIO_CONFIG_NEXT, STUDIO_CONFIG_ASTRO;
+var init_studio = __esm(() => {
+  STUDIO_PACKAGE_JSON = j5({
+    name: "studio",
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    scripts: {
+      build: "sanity build",
+      "check-types": "tsc --noEmit",
+      dev: "sanity dev",
+      extract: "sanity schema extract --enforce-required-fields",
+      "sanity:seed": "sanity dataset import seed.ndjson",
+      type: "sanity typegen generate"
+    },
+    dependencies: {
+      "@workspace/sanity-blocks": "workspace:*",
+      react: "^19.0.0",
+      "react-dom": "^19.0.0",
+      sanity: "^5.31.1",
+      "styled-components": "^6.1.15"
+    },
+    devDependencies: {
+      "@types/node": "^22.10.0",
+      "@types/react": "^19.0.0",
+      "@workspace/typescript-config": "workspace:*",
+      typescript: "^5.9.0"
+    }
+  });
+  STUDIO_TSCONFIG = j5({
+    extends: "@workspace/typescript-config/react-library.json",
+    include: ["**/*.ts", "**/*.tsx"],
+    exclude: ["node_modules", "dist"]
+  });
+  STUDIO_ENV_EXAMPLE_NEXT = studioEnvExample(NEXT_SITE_URL);
+  STUDIO_ENV_EXAMPLE_ASTRO = studioEnvExample(ASTRO_SITE_URL);
+  STUDIO_CONFIG_NEXT = studioConfig(NEXT_SITE_URL, `
+        previewMode: {
+          enable: "/api/draft-mode/enable",
+          // Presentation never calls this itself (documented as not yet implemented);
+          // editors leave draft mode via <DisableDraftMode/>, which links to the route.
+          disable: "/api/draft-mode/disable",
+        },`);
+  STUDIO_CONFIG_ASTRO = studioConfig(ASTRO_SITE_URL, `
+        // No previewMode: Astro has no draft-mode routes. Draft content comes from
+        // loadQuery's perspective switch (PUBLIC_SANITY_VISUAL_EDITING_ENABLED + a read
+        // token), which needs a rendering server — \`astro dev\`, or an SSR adapter.`);
+});
+
+// ../../packages/registry/src/content/sanity/types.ts
+var SANITY_TYPES = `/**
+ * ---------------------------------------------------------------------------------
+ * This file has been generated by Sanity TypeGen.
+ * Command: \`sanity typegen generate\`
+ *
+ * Any modifications made directly to this file will be overwritten the next time
+ * the TypeScript definitions are generated. Please make changes to the Sanity
+ * schema definitions and/or GROQ queries if you need to update these types.
+ *
+ * For more information on how to use Sanity TypeGen, visit the official documentation:
+ * https://www.sanity.io/docs/sanity-typegen
+ * ---------------------------------------------------------------------------------
  */
-export async function loadQuery<T>(
-  query: string,
-  params: Record<string, unknown> = {},
-): Promise<T | null> {
-  if (!hasSanityCredentials) return null;
-  if (visualEditingEnabled && !readToken) {
-    throw new Error(
-      "SANITY_API_READ_TOKEN is required when PUBLIC_SANITY_VISUAL_EDITING_ENABLED is true.",
-    );
-  }
-  try {
-    const { result } = await sanityClient.fetch<T>(query, params, {
-      filterResponse: false,
-      perspective: visualEditingEnabled ? "drafts" : "published",
-      resultSourceMap: visualEditingEnabled ? "withKeyArraySelector" : false,
-      stega: visualEditingEnabled,
-      ...(visualEditingEnabled ? { token: readToken } : {}),
-      useCdn: !visualEditingEnabled,
-    });
-    return result;
-  } catch (error) {
-    console.warn("[sanity] query failed:", error);
-    return null;
-  }
-}
-`, ASTRO_IMAGE = `import { createImageUrlBuilder } from "@sanity/image-url";
-import { dataset, projectId } from "./env";
 
-const builder = createImageUrlBuilder({ projectId, dataset });
+export declare const internalGroqTypeReferenceTo: unique symbol;
 
-/** Build a CDN URL for a Sanity image; null when the block has no asset. */
-export function urlFor(source: unknown, width = 1200): string | null {
-  const ref = (source as { asset?: { _ref?: string } } | null)?.asset?._ref;
-  if (!ref) return null;
-  return builder.image(ref).width(width).auto("format").url();
-}
-`, ASTRO_TYPES = `import type { PortableTextBlock } from "@portabletext/types";
+// Source: schema.json
+export type SanityImageAssetReference = {
+  _ref: string;
+  _type: "reference";
+  _weak?: boolean;
+  [internalGroqTypeReferenceTo]?: "sanity.imageAsset";
+};
 
-type SanityImage = { asset?: { _ref?: string } | null; alt?: string | null } | null;
+export type Image1 = {
+  asset?: SanityImageAssetReference;
+  media?: unknown; // Unable to locate the referenced type "image.media" in schema
+  hotspot?: SanityImageHotspot;
+  crop?: SanityImageCrop;
+  alt?: string;
+  _type: "image";
+};
 
-export type PageBlock =
-  | { _key: string; _type: "hero"; heading?: string; subheading?: string; image?: SanityImage }
-  | { _key: string; _type: "richText"; heading?: string; content?: PortableTextBlock[] }
+export type Cta = {
+  _type: "cta";
+  eyebrow?: string;
+  title?: string;
+  richText?: RichText;
+  buttons?: Array<
+    {
+      _key: string;
+    } & Button
+  >;
+};
+
+export type SubscribeNewsletter = {
+  _type: "subscribeNewsletter";
+  title?: string;
+  subTitle?: RichText;
+  helperText?: RichText;
+};
+
+export type FaqReference = {
+  _ref: string;
+  _type: "reference";
+  _weak?: boolean;
+  [internalGroqTypeReferenceTo]?: "faq";
+};
+
+export type FaqAccordion = {
+  _type: "faqAccordion";
+  eyebrow?: string;
+  title: string;
+  subtitle?: string;
+  faqs?: Array<
+    {
+      _key: string;
+    } & FaqReference
+  >;
+};
+
+export type ImageLinkCards = {
+  _type: "imageLinkCards";
+  eyebrow?: string;
+  title: string;
+  richText?: RichText;
+  buttons?: Array<
+    {
+      _key: string;
+    } & Button
+  >;
+  cards?: Array<{
+    title: string;
+    description?: string;
+    image?: Image1;
+    url?: CustomUrl;
+    _type: "imageLinkCard";
+    _key: string;
+  }>;
+};
+
+export type FeatureCardsIcon = {
+  _type: "featureCardsIcon";
+  eyebrow?: string;
+  title?: string;
+  richText?: RichText;
+  cards?: Array<{
+    icon?: string;
+    title?: string;
+    richText?: RichText;
+    _type: "featureCardIcon";
+    _key: string;
+  }>;
+};
+
+export type RichTextBlock = {
+  _type: "richTextBlock";
+  eyebrow?: string;
+  title?: string;
+  richText?: RichText;
+};
+
+export type Hero = {
+  _type: "hero";
+  badge?: string;
+  title?: string;
+  richText?: RichText;
+  image?: Image1;
+  buttons?: Array<
+    {
+      _key: string;
+    } & Button
+  >;
+};
+
+export type RichText = Array<
   | {
+      children?: Array<{
+        marks?: Array<string>;
+        text?: string;
+        _type: "span";
+        _key: string;
+      }>;
+      style?: "normal" | "h2" | "h3" | "h4";
+      listItem?: "bullet" | "number";
+      markDefs?: Array<{
+        customLink?: CustomUrl;
+        _type: "customLink";
+        _key: string;
+      }>;
+      level?: number;
+      _type: "block";
       _key: string;
-      _type: "cta";
-      heading?: string;
-      text?: string;
-      buttonLabel?: string;
-      buttonHref?: string;
-    };
+    }
+  | {
+      asset?: SanityImageAssetReference;
+      media?: unknown;
+      hotspot?: SanityImageHotspot;
+      crop?: SanityImageCrop;
+      caption?: string;
+      _type: "image";
+      _key: string;
+    }
+>;
+
+export type Button = {
+  _type: "button";
+  variant?: "default" | "secondary" | "outline" | "link";
+  text?: string;
+  url?: CustomUrl;
+};
+
+export type PageReference = {
+  _ref: string;
+  _type: "reference";
+  _weak?: boolean;
+  [internalGroqTypeReferenceTo]?: "page";
+};
+
+export type BlogReference = {
+  _ref: string;
+  _type: "reference";
+  _weak?: boolean;
+  [internalGroqTypeReferenceTo]?: "blog";
+};
+
+export type CustomUrl = {
+  _type: "customUrl";
+  type: "internal" | "external";
+  openInNewTab?: boolean;
+  external?: string;
+  internal?: PageReference | BlogReference;
+};
+
+export type Settings = {
+  _id: string;
+  _type: "settings";
+  _createdAt: string;
+  _updatedAt: string;
+  _rev: string;
+  siteTitle: string;
+  siteDescription?: string;
+  socialImage?: {
+    asset?: SanityImageAssetReference;
+    media?: unknown;
+    hotspot?: SanityImageHotspot;
+    crop?: SanityImageCrop;
+    _type: "image";
+  };
+};
+
+export type SanityImageCrop = {
+  _type: "sanity.imageCrop";
+  top: number;
+  bottom: number;
+  left: number;
+  right: number;
+};
+
+export type SanityImageHotspot = {
+  _type: "sanity.imageHotspot";
+  x: number;
+  y: number;
+  height: number;
+  width: number;
+};
 
-export type SanityPage = {
+export type Faq = {
   _id: string;
+  _type: "faq";
+  _createdAt: string;
+  _updatedAt: string;
+  _rev: string;
+  title: string;
+  richText?: RichText;
+};
+
+export type Author = {
+  _id: string;
+  _type: "author";
+  _createdAt: string;
+  _updatedAt: string;
+  _rev: string;
+  name: string;
+  position?: string;
+  image?: {
+    asset?: SanityImageAssetReference;
+    media?: unknown;
+    hotspot?: SanityImageHotspot;
+    crop?: SanityImageCrop;
+    _type: "image";
+  };
+  bio?: string;
+};
+
+export type AuthorReference = {
+  _ref: string;
+  _type: "reference";
+  _weak?: boolean;
+  [internalGroqTypeReferenceTo]?: "author";
+};
+
+export type Blog = {
+  _id: string;
+  _type: "blog";
+  _createdAt: string;
+  _updatedAt: string;
+  _rev: string;
+  title: string;
+  slug: Slug;
+  description?: string;
+  authors?: Array<
+    {
+      _key: string;
+    } & AuthorReference
+  >;
+  publishedAt?: string;
+  image?: {
+    asset?: SanityImageAssetReference;
+    media?: unknown;
+    hotspot?: SanityImageHotspot;
+    crop?: SanityImageCrop;
+    alt?: string;
+    _type: "image";
+  };
+  richText?: RichText;
+};
+
+export type Slug = {
+  _type: "slug";
+  current: string;
+  source?: string;
+};
+
+export type Page = {
+  _id: string;
+  _type: "page";
+  _createdAt: string;
+  _updatedAt: string;
+  _rev: string;
+  title: string;
+  slug: Slug;
+  description?: string;
+  image?: {
+    asset?: SanityImageAssetReference;
+    media?: unknown;
+    hotspot?: SanityImageHotspot;
+    crop?: SanityImageCrop;
+    _type: "image";
+  };
+  pageBuilder?: Array<
+    | ({
+        _key: string;
+      } & Hero)
+    | ({
+        _key: string;
+      } & RichTextBlock)
+    | ({
+        _key: string;
+      } & FeatureCardsIcon)
+    | ({
+        _key: string;
+      } & ImageLinkCards)
+    | ({
+        _key: string;
+      } & FaqAccordion)
+    | ({
+        _key: string;
+      } & SubscribeNewsletter)
+    | ({
+        _key: string;
+      } & Cta)
+  >;
+};
+
+export type SanityImagePaletteSwatch = {
+  _type: "sanity.imagePaletteSwatch";
+  background?: string;
+  foreground?: string;
+  population?: number;
+  title?: string;
+};
+
+export type SanityImagePalette = {
+  _type: "sanity.imagePalette";
+  darkMuted?: SanityImagePaletteSwatch;
+  lightVibrant?: SanityImagePaletteSwatch;
+  darkVibrant?: SanityImagePaletteSwatch;
+  vibrant?: SanityImagePaletteSwatch;
+  dominant?: SanityImagePaletteSwatch;
+  lightMuted?: SanityImagePaletteSwatch;
+  muted?: SanityImagePaletteSwatch;
+};
+
+export type SanityImageDimensions = {
+  _type: "sanity.imageDimensions";
+  height: number;
+  width: number;
+  aspectRatio: number;
+};
+
+export type SanityImageMetadata = {
+  _type: "sanity.imageMetadata";
+  location?: Geopoint;
+  dimensions?: SanityImageDimensions;
+  palette?: SanityImagePalette;
+  lqip?: string;
+  blurHash?: string;
+  thumbHash?: string;
+  hasAlpha?: boolean;
+  isOpaque?: boolean;
+};
+
+export type SanityFileAsset = {
+  _id: string;
+  _type: "sanity.fileAsset";
+  _createdAt: string;
+  _updatedAt: string;
+  _rev: string;
+  originalFilename?: string;
+  label?: string;
+  title?: string;
+  description?: string;
+  altText?: string;
+  sha1hash: string;
+  extension: string;
+  mimeType: string;
+  size: number;
+  assetId: string;
+  uploadId?: string;
+  path: string;
+  url: string;
+  source?: SanityAssetSourceData;
+};
+
+export type SanityAssetSourceData = {
+  _type: "sanity.assetSourceData";
+  name?: string;
+  id?: string;
+  url?: string;
+};
+
+export type SanityImageAsset = {
+  _id: string;
+  _type: "sanity.imageAsset";
+  _createdAt: string;
+  _updatedAt: string;
+  _rev: string;
+  originalFilename?: string;
+  label?: string;
   title?: string;
   description?: string;
-  slug?: string;
-  pageBuilder?: PageBlock[] | null;
+  altText?: string;
+  sha1hash: string;
+  extension: string;
+  mimeType: string;
+  size: number;
+  assetId: string;
+  uploadId?: string;
+  path: string;
+  url: string;
+  metadata?: SanityImageMetadata;
+  source?: SanityAssetSourceData;
+};
+
+export type Geopoint = {
+  _type: "geopoint";
+  lat?: number;
+  lng?: number;
+  alt?: number;
+};
+
+export type AllSanitySchemaTypes =
+  | SanityImageAssetReference
+  | Image1
+  | Cta
+  | SubscribeNewsletter
+  | FaqReference
+  | FaqAccordion
+  | ImageLinkCards
+  | FeatureCardsIcon
+  | RichTextBlock
+  | Hero
+  | RichText
+  | Button
+  | PageReference
+  | BlogReference
+  | CustomUrl
+  | Settings
+  | SanityImageCrop
+  | SanityImageHotspot
+  | Faq
+  | Author
+  | AuthorReference
+  | Blog
+  | Slug
+  | Page
+  | SanityImagePaletteSwatch
+  | SanityImagePalette
+  | SanityImageDimensions
+  | SanityImageMetadata
+  | SanityFileAsset
+  | SanityAssetSourceData
+  | SanityImageAsset
+  | Geopoint;
+
+// Source: ../../packages/sanity/src/queries.ts
+// Variable: HOME_PAGE_QUERY
+// Query: *[_type == "page" && slug.current == "home"][0]{  _id,  _type,  title,  description,  "slug": slug.current,    pageBuilder[]{    ...,    buttons[]{ _key, _type, text, variant,   "openInNewTab": url.openInNewTab,  "href": select(    url.type == "external" => url.external,    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,    url.internal->slug.current == "home" => "/",    defined(url.internal->slug.current) => "/" + url.internal->slug.current,    "#"  ) },    _type == "faqAccordion" => { faqs[]->{ _id, title, richText } },    _type == "imageLinkCards" => { cards[]{ ...,   "openInNewTab": url.openInNewTab,  "href": select(    url.type == "external" => url.external,    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,    url.internal->slug.current == "home" => "/",    defined(url.internal->slug.current) => "/" + url.internal->slug.current,    "#"  ) } }  }}
+export type HOME_PAGE_QUERY_RESULT = {
+  _id: string;
+  _type: "page";
+  title: string;
+  description: string | null;
+  slug: string;
+  pageBuilder: Array<
+    | {
+        _key: string;
+        _type: "cta";
+        eyebrow?: string;
+        title?: string;
+        richText?: RichText;
+        buttons: Array<{
+          _key: string;
+          _type: "button";
+          text: string | null;
+          variant: "default" | "link" | "outline" | "secondary" | null;
+          openInNewTab: boolean | null;
+          href: string | "/" | "#" | null;
+        }> | null;
+      }
+    | {
+        _key: string;
+        _type: "faqAccordion";
+        eyebrow?: string;
+        title: string;
+        subtitle?: string;
+        faqs: Array<{
+          _id: string;
+          title: string;
+          richText: RichText | null;
+        }> | null;
+        buttons: null;
+      }
+    | {
+        _key: string;
+        _type: "featureCardsIcon";
+        eyebrow?: string;
+        title?: string;
+        richText?: RichText;
+        cards?: Array<{
+          icon?: string;
+          title?: string;
+          richText?: RichText;
+          _type: "featureCardIcon";
+          _key: string;
+        }>;
+        buttons: null;
+      }
+    | {
+        _key: string;
+        _type: "hero";
+        badge?: string;
+        title?: string;
+        richText?: RichText;
+        image?: Image1;
+        buttons: Array<{
+          _key: string;
+          _type: "button";
+          text: string | null;
+          variant: "default" | "link" | "outline" | "secondary" | null;
+          openInNewTab: boolean | null;
+          href: string | "/" | "#" | null;
+        }> | null;
+      }
+    | {
+        _key: string;
+        _type: "imageLinkCards";
+        eyebrow?: string;
+        title: string;
+        richText?: RichText;
+        buttons: Array<{
+          _key: string;
+          _type: "button";
+          text: string | null;
+          variant: "default" | "link" | "outline" | "secondary" | null;
+          openInNewTab: boolean | null;
+          href: string | "/" | "#" | null;
+        }> | null;
+        cards: Array<{
+          title: string;
+          description?: string;
+          image?: Image1;
+          url?: CustomUrl;
+          _type: "imageLinkCard";
+          _key: string;
+          openInNewTab: boolean | null;
+          href: string | "/" | "#" | null;
+        }> | null;
+      }
+    | {
+        _key: string;
+        _type: "richTextBlock";
+        eyebrow?: string;
+        title?: string;
+        richText?: RichText;
+        buttons: null;
+      }
+    | {
+        _key: string;
+        _type: "subscribeNewsletter";
+        title?: string;
+        subTitle?: RichText;
+        helperText?: RichText;
+        buttons: null;
+      }
+  > | null;
+} | null;
+
+// Source: ../../packages/sanity/src/queries.ts
+// Variable: PAGE_QUERY
+// Query: *[_type == "page" && slug.current == $slug][0]{  _id,  _type,  title,  description,  "slug": slug.current,    pageBuilder[]{    ...,    buttons[]{ _key, _type, text, variant,   "openInNewTab": url.openInNewTab,  "href": select(    url.type == "external" => url.external,    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,    url.internal->slug.current == "home" => "/",    defined(url.internal->slug.current) => "/" + url.internal->slug.current,    "#"  ) },    _type == "faqAccordion" => { faqs[]->{ _id, title, richText } },    _type == "imageLinkCards" => { cards[]{ ...,   "openInNewTab": url.openInNewTab,  "href": select(    url.type == "external" => url.external,    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,    url.internal->slug.current == "home" => "/",    defined(url.internal->slug.current) => "/" + url.internal->slug.current,    "#"  ) } }  }}
+export type PAGE_QUERY_RESULT = {
+  _id: string;
+  _type: "page";
+  title: string;
+  description: string | null;
+  slug: string;
+  pageBuilder: Array<
+    | {
+        _key: string;
+        _type: "cta";
+        eyebrow?: string;
+        title?: string;
+        richText?: RichText;
+        buttons: Array<{
+          _key: string;
+          _type: "button";
+          text: string | null;
+          variant: "default" | "link" | "outline" | "secondary" | null;
+          openInNewTab: boolean | null;
+          href: string | "/" | "#" | null;
+        }> | null;
+      }
+    | {
+        _key: string;
+        _type: "faqAccordion";
+        eyebrow?: string;
+        title: string;
+        subtitle?: string;
+        faqs: Array<{
+          _id: string;
+          title: string;
+          richText: RichText | null;
+        }> | null;
+        buttons: null;
+      }
+    | {
+        _key: string;
+        _type: "featureCardsIcon";
+        eyebrow?: string;
+        title?: string;
+        richText?: RichText;
+        cards?: Array<{
+          icon?: string;
+          title?: string;
+          richText?: RichText;
+          _type: "featureCardIcon";
+          _key: string;
+        }>;
+        buttons: null;
+      }
+    | {
+        _key: string;
+        _type: "hero";
+        badge?: string;
+        title?: string;
+        richText?: RichText;
+        image?: Image1;
+        buttons: Array<{
+          _key: string;
+          _type: "button";
+          text: string | null;
+          variant: "default" | "link" | "outline" | "secondary" | null;
+          openInNewTab: boolean | null;
+          href: string | "/" | "#" | null;
+        }> | null;
+      }
+    | {
+        _key: string;
+        _type: "imageLinkCards";
+        eyebrow?: string;
+        title: string;
+        richText?: RichText;
+        buttons: Array<{
+          _key: string;
+          _type: "button";
+          text: string | null;
+          variant: "default" | "link" | "outline" | "secondary" | null;
+          openInNewTab: boolean | null;
+          href: string | "/" | "#" | null;
+        }> | null;
+        cards: Array<{
+          title: string;
+          description?: string;
+          image?: Image1;
+          url?: CustomUrl;
+          _type: "imageLinkCard";
+          _key: string;
+          openInNewTab: boolean | null;
+          href: string | "/" | "#" | null;
+        }> | null;
+      }
+    | {
+        _key: string;
+        _type: "richTextBlock";
+        eyebrow?: string;
+        title?: string;
+        richText?: RichText;
+        buttons: null;
+      }
+    | {
+        _key: string;
+        _type: "subscribeNewsletter";
+        title?: string;
+        subTitle?: RichText;
+        helperText?: RichText;
+        buttons: null;
+      }
+  > | null;
 } | null;
-`, ASTRO_PAGE_BUILDER = `---
-import { PortableText } from "astro-portabletext";
-import type { PageBlock } from "../../sanity/types";
-import { urlFor } from "../../sanity/image";
 
-interface Props {
-  blocks: PageBlock[];
-}
+// Source: ../../packages/sanity/src/queries.ts
+// Variable: PAGE_SLUGS_QUERY
+// Query: *[_type == "page" && defined(slug.current) && slug.current != "home"].slug.current
+export type PAGE_SLUGS_QUERY_RESULT = Array<string>;
 
-const { blocks } = Astro.props;
----
+// Source: ../../packages/sanity/src/queries.ts
+// Variable: BLOG_INDEX_QUERY
+// Query: *[_type == "blog" && defined(slug.current)]|order(publishedAt desc){  _id,  title,  description,  publishedAt,  image,  "slug": slug.current,  "authors": authors[]->{ _id, name, position, image }}
+export type BLOG_INDEX_QUERY_RESULT = Array<{
+  _id: string;
+  title: string;
+  description: string | null;
+  publishedAt: string | null;
+  image: {
+    asset?: SanityImageAssetReference;
+    media?: unknown;
+    hotspot?: SanityImageHotspot;
+    crop?: SanityImageCrop;
+    alt?: string;
+    _type: "image";
+  } | null;
+  slug: string;
+  authors: Array<{
+    _id: string;
+    name: string;
+    position: string | null;
+    image: {
+      asset?: SanityImageAssetReference;
+      media?: unknown;
+      hotspot?: SanityImageHotspot;
+      crop?: SanityImageCrop;
+      _type: "image";
+    } | null;
+  }> | null;
+}>;
+
+// Source: ../../packages/sanity/src/queries.ts
+// Variable: BLOG_QUERY
+// Query: *[_type == "blog" && slug.current == $slug][0]{  _id,  title,  description,  publishedAt,  image,  "slug": slug.current,  "authors": authors[]->{ _id, name, position, image }, richText}
+export type BLOG_QUERY_RESULT = {
+  _id: string;
+  title: string;
+  description: string | null;
+  publishedAt: string | null;
+  image: {
+    asset?: SanityImageAssetReference;
+    media?: unknown;
+    hotspot?: SanityImageHotspot;
+    crop?: SanityImageCrop;
+    alt?: string;
+    _type: "image";
+  } | null;
+  slug: string;
+  authors: Array<{
+    _id: string;
+    name: string;
+    position: string | null;
+    image: {
+      asset?: SanityImageAssetReference;
+      media?: unknown;
+      hotspot?: SanityImageHotspot;
+      crop?: SanityImageCrop;
+      _type: "image";
+    } | null;
+  }> | null;
+  richText: RichText | null;
+} | null;
 
-{
-  blocks.map((block) => {
-    if (block._type === "hero") {
-      const src = urlFor(block.image, 1600);
-      return (
-        <section>
-          <h2>{block.heading}</h2>
-          {block.subheading && <p>{block.subheading}</p>}
-          {src && <img src={src} alt={block.image?.alt ?? ""} />}
-        </section>
-      );
-    }
-    if (block._type === "richText") {
-      return (
-        <section>
-          {block.heading && <h2>{block.heading}</h2>}
-          {block.content && <PortableText value={block.content} />}
-        </section>
-      );
-    }
-    if (block._type === "cta") {
-      return (
-        <section>
-          <h2>{block.heading}</h2>
-          {block.text && <p>{block.text}</p>}
-          {block.buttonHref && block.buttonLabel && (
-            <a href={block.buttonHref}>{block.buttonLabel}</a>
-          )}
-        </section>
-      );
-    }
-    return null;
-  })
-}
-`, ASTRO_SLUG_PAGE = `---
-import { VisualEditing } from "@sanity/astro/visual-editing";
-import PageBuilder from "../components/PageBuilder.astro";
-import { visualEditingEnabled } from "../../sanity/env";
-import { loadQuery } from "../../sanity/fetch";
-import { PAGE_QUERY, PAGE_SLUGS_QUERY } from "../../sanity/queries";
-import type { SanityPage } from "../../sanity/types";
+// Source: ../../packages/sanity/src/queries.ts
+// Variable: BLOG_SLUGS_QUERY
+// Query: *[_type == "blog" && defined(slug.current)].slug.current
+export type BLOG_SLUGS_QUERY_RESULT = Array<string>;
+
+// Source: ../../packages/sanity/src/queries.ts
+// Variable: SETTINGS_QUERY
+// Query: *[_type == "settings"][0]{ siteTitle, siteDescription, socialImage }
+export type SETTINGS_QUERY_RESULT = {
+  siteTitle: string;
+  siteDescription: string | null;
+  socialImage: {
+    asset?: SanityImageAssetReference;
+    media?: unknown;
+    hotspot?: SanityImageHotspot;
+    crop?: SanityImageCrop;
+    _type: "image";
+  } | null;
+} | null;
 
-export async function getStaticPaths() {
-  // Returns [] without credentials, so a fresh scaffold builds with no CMS pages.
-  const slugs = await loadQuery<(string | null)[]>(PAGE_SLUGS_QUERY);
-  return (slugs ?? []).filter(Boolean).map((slug) => ({ params: { slug } }));
+// Query TypeMap
+import "@sanity/client";
+declare module "@sanity/client" {
+  interface SanityQueries {
+    '*[_type == "page" && slug.current == "home"][0]{\\n  _id,\\n  _type,\\n  title,\\n  description,\\n  "slug": slug.current,\\n  \\n  pageBuilder[]{\\n    ...,\\n    buttons[]{ _key, _type, text, variant, \\n  "openInNewTab": url.openInNewTab,\\n  "href": select(\\n    url.type == "external" => url.external,\\n    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,\\n    url.internal->slug.current == "home" => "/",\\n    defined(url.internal->slug.current) => "/" + url.internal->slug.current,\\n    "#"\\n  )\\n },\\n    _type == "faqAccordion" => { faqs[]->{ _id, title, richText } },\\n    _type == "imageLinkCards" => { cards[]{ ..., \\n  "openInNewTab": url.openInNewTab,\\n  "href": select(\\n    url.type == "external" => url.external,\\n    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,\\n    url.internal->slug.current == "home" => "/",\\n    defined(url.internal->slug.current) => "/" + url.internal->slug.current,\\n    "#"\\n  )\\n } }\\n  }\\n\\n}': HOME_PAGE_QUERY_RESULT;
+    '*[_type == "page" && slug.current == $slug][0]{\\n  _id,\\n  _type,\\n  title,\\n  description,\\n  "slug": slug.current,\\n  \\n  pageBuilder[]{\\n    ...,\\n    buttons[]{ _key, _type, text, variant, \\n  "openInNewTab": url.openInNewTab,\\n  "href": select(\\n    url.type == "external" => url.external,\\n    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,\\n    url.internal->slug.current == "home" => "/",\\n    defined(url.internal->slug.current) => "/" + url.internal->slug.current,\\n    "#"\\n  )\\n },\\n    _type == "faqAccordion" => { faqs[]->{ _id, title, richText } },\\n    _type == "imageLinkCards" => { cards[]{ ..., \\n  "openInNewTab": url.openInNewTab,\\n  "href": select(\\n    url.type == "external" => url.external,\\n    url.internal->_type == "blog" => "/blog/" + url.internal->slug.current,\\n    url.internal->slug.current == "home" => "/",\\n    defined(url.internal->slug.current) => "/" + url.internal->slug.current,\\n    "#"\\n  )\\n } }\\n  }\\n\\n}': PAGE_QUERY_RESULT;
+    '*[_type == "page" && defined(slug.current) && slug.current != "home"].slug.current': PAGE_SLUGS_QUERY_RESULT;
+    '*[_type == "blog" && defined(slug.current)]|order(publishedAt desc){\\n  _id,\\n  title,\\n  description,\\n  publishedAt,\\n  image,\\n  "slug": slug.current,\\n  "authors": authors[]->{ _id, name, position, image }\\n}': BLOG_INDEX_QUERY_RESULT;
+    '*[_type == "blog" && slug.current == $slug][0]{\\n  _id,\\n  title,\\n  description,\\n  publishedAt,\\n  image,\\n  "slug": slug.current,\\n  "authors": authors[]->{ _id, name, position, image }\\n, richText}': BLOG_QUERY_RESULT;
+    '*[_type == "blog" && defined(slug.current)].slug.current': BLOG_SLUGS_QUERY_RESULT;
+    '*[_type == "settings"][0]{ siteTitle, siteDescription, socialImage }': SETTINGS_QUERY_RESULT;
+  }
 }
+`;
 
-const page = await loadQuery<SanityPage>(PAGE_QUERY, { slug: Astro.params.slug });
----
-
-<html lang="en">
-  <head>
-    <meta charset="utf-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1" />
-    <title>{page?.title ?? "web"}</title>
-  </head>
-  <body style="font-family: system-ui, sans-serif; padding: 3rem;">
-    <h1>{page?.title}</h1>
-    <PageBuilder blocks={page?.pageBuilder ?? []} />
-    <VisualEditing enabled={visualEditingEnabled} />
-  </body>
-</html>
-`, ASTRO_SANITY_CONFIG, ASTRO_SANITY_CLI = `import { defineCliConfig } from "sanity/cli";
-
-// Run from apps/web. The Sanity CLI is a Node process, so it reads process.env rather
-// than Astro's import.meta.env; astro.config.mjs loads apps/web/.env into it.
-export default defineCliConfig({
-  api: {
-    projectId: process.env.PUBLIC_SANITY_PROJECT_ID || "placeholder",
-    dataset: process.env.PUBLIC_SANITY_DATASET || "production",
-  },
-  typegen: {
-    path: "./sanity/**/*.{ts,tsx}",
-    schema: "sanity/schema.json",
-    generates: "sanity/sanity.types.ts",
-  },
-});
-`, ASTRO_MODULE_REF = '/// <reference types="@sanity/astro/module" />', ASTRO_ENV_LOADER = `// Astro loads .env after this config runs, so pull it in ourselves for the Sanity ids.
-try {
-  process.loadEnvFile(".env");
-} catch {
-  // No .env — the placeholder ids below keep the build working.
-}
-`, prependAstroConfigStatement = (content, block, marker) => content.includes(marker) ? content : content.replace("export default defineConfig({", `${block}
+// ../../packages/registry/src/content/sanity/index.ts
+var j6 = (value) => `${JSON.stringify(value, null, 2)}
+`, SANITY_PACKAGE_JSON, SANITY_BLOCKS_PACKAGE_JSON, prependAstroConfigStatement = (content, block, marker) => content.includes(marker) ? content : content.replace("export default defineConfig({", `${block}
 export default defineConfig({`), addAstroOptimizeDeps = (content) => {
   if (content.includes("react/compiler-runtime"))
     return content;
@@ -1562,23 +3631,12 @@ export default defineConfig({`), addAstroOptimizeDeps = (content) => {
     return content.replace(/vite:\s*\{/, (m) => `${m} ${field}`);
   return content.replace(/defineConfig\(\{/, (m) => `${m}
   vite: { ${field} },`);
-}, addScripts = (pkgJson, scripts) => {
-  const pkg = JSON.parse(pkgJson);
-  const merged = { ...pkg.scripts, ...scripts };
-  const sorted = Object.fromEntries(Object.entries(merged).sort(([a], [b]) => a.localeCompare(b)));
-  return `${JSON.stringify({ ...pkg, scripts: sorted }, null, 2)}
-`;
-}, TYPEGEN = "sanity schema extract --enforce-required-fields --path sanity/schema.json && sanity typegen generate", patchWebPackageJson = (content) => addScripts(content, {
-  "sanity:typegen": TYPEGEN,
-  prebuild: TYPEGEN,
-  ...content.includes('"next build"') ? { "precheck-types": TYPEGEN } : {},
-  "sanity:seed": "sanity dataset import sanity/seed.ndjson"
-}), NEXT_LAYOUT_SIGNATURE = "export default function RootLayout({ children }: { children: ReactNode }) {", patchNextLayout = (content) => {
+}, NEXT_LAYOUT_SIGNATURE = "export default function RootLayout({ children }: { children: ReactNode }) {", patchNextLayout = (content) => {
   const withImports = [
     'import { draftMode } from "next/headers";',
     'import { VisualEditing } from "next-sanity/visual-editing";',
     'import { DisableDraftMode } from "../sanity/disable-draft-mode";',
-    'import { SanityLive } from "../sanity/live";'
+    'import { SanityLive } from "@workspace/sanity/live";'
   ].reduce(ensureImport, content);
   const asAsync = replaceOnce(withImports, NEXT_LAYOUT_SIGNATURE, `export default async function RootLayout({ children }: { children: ReactNode }) {
   const { isEnabled: isDraft } = await draftMode();`);
@@ -1600,15 +3658,15 @@ export default defineConfig({`), addAstroOptimizeDeps = (content) => {
     return content;
   const withImports = [
     'import { VisualEditing } from "@sanity/astro/visual-editing";',
-    'import PageBuilder from "../components/PageBuilder.astro";',
-    'import { visualEditingEnabled } from "../../sanity/env";',
-    'import { loadQuery } from "../../sanity/fetch";',
-    'import { HOME_PAGE_QUERY } from "../../sanity/queries";',
-    'import type { SanityPage } from "../../sanity/types";'
+    'import { visualEditingEnabled } from "@workspace/sanity/env";',
+    'import { loadQuery } from "@workspace/sanity/fetch";',
+    'import { HOME_PAGE_QUERY } from "@workspace/sanity/queries";',
+    'import type { HOME_PAGE_QUERY_RESULT } from "@workspace/sanity/types";',
+    'import PageBuilder from "@workspace/sanity-blocks/PageBuilder.astro";'
   ].reduce(ensureImport, content);
   const withFetch = replaceOnce(withImports, 'log.info("rendering home");', `log.info("rendering home");
 
-const page = await loadQuery<SanityPage>(HOME_PAGE_QUERY);`);
+const page = await loadQuery<HOME_PAGE_QUERY_RESULT>(HOME_PAGE_QUERY);`);
   const withHeading = replaceOnce(withFetch, "    <h1>create-turbo-wizard</h1>", '    <h1>{page?.title ?? "create-turbo-wizard"}</h1>');
   const withBlocks = replaceOnce(withHeading, "    <p>Astro + Turborepo, scaffolded.</p>", [
     "    <PageBuilder blocks={page?.pageBuilder ?? []} />",
@@ -1622,136 +3680,142 @@ const page = await loadQuery<SanityPage>(HOME_PAGE_QUERY);`);
 }, README_SECTION = `
 ## Sanity
 
-The Studio is embedded in \`apps/web\` — Next serves it at \`/studio\`, Astro at \`/admin\`.
-Schema, queries and sample content live in \`apps/web/sanity/\`.
+The Studio is its own app, \`apps/studio\` (\`pnpm dev:studio\`, port 3333) — a Vite app, so
+both frontends share the same one. It owns the document schemas, Studio structure and
+sample content. The read path (client, queries, generated types) is \`packages/sanity\` and
+the page-builder blocks — schemas and renderers together — are \`packages/sanity-blocks\`.
 
 \`\`\`sh
-cd apps/web
-cp ../../.env.example .env.local   # Astro: .env — then fill in the project id
-pnpm sanity:seed                   # import sanity/seed.ndjson into the configured dataset
-pnpm sanity:typegen                # regenerate sanity/sanity.types.ts (also runs on build)
+cp .env.example apps/web/.env.local            # or apps/web/.env on Astro — the project id
+cp apps/studio/.env.example apps/studio/.env   # and SANITY_STUDIO_PROJECT_ID
+pnpm dev:studio                                # the Studio on http://localhost:3333
+cd apps/studio && pnpm sanity:seed             # import seed.ndjson into the dataset
+cd apps/studio && pnpm extract && pnpm type    # regenerate packages/sanity/src/sanity.types.ts
 \`\`\`
 
+\`packages/sanity/src/sanity.types.ts\` ships pre-generated, so a fresh clone type-checks
+before anything is run; re-run \`extract\` + \`type\` after every schema or query edit.
+
 Without a project id the site builds and serves an empty state — no credentials required.
 
+### What's in the schema
+
+\`page\` documents compose a page builder out of seven blocks — hero, rich text, feature
+cards, image link cards, FAQ accordion, newsletter and CTA — and \`blog\` posts carry an
+\`author\` reference, a publish date and a Portable Text body. Pages route by slug
+(\`/about\`), posts live under \`/blog\`. The shape follows Roboto Studio's
+\`turbo-start-sanity\`, so components and GROQ from that repo drop in unchanged.
+
+Links are stored as \`customUrl\` (internal document or external URL) and flattened to a
+plain \`href\` in \`packages/sanity/src/queries.ts\`, so components never branch on the
+link type.
+
 ### Visual Editing
 
 Next: open the Studio's **Presentation** tab — draft mode enables via
 \`/api/draft-mode/enable\`; leave it with the on-page "Disable draft mode" button.
 Astro: set \`PUBLIC_SANITY_VISUAL_EDITING_ENABLED=true\` and \`SANITY_API_READ_TOKEN\`,
 then use the dev server — overlays need server rendering (add an SSR adapter for a
-production preview deployment).
+production preview deployment). \`PUBLIC_SANITY_STUDIO_URL\` is where stega sends a
+click-through; it defaults to the Studio's own dev origin.
 `, sanity;
 var init_sanity = __esm(() => {
-  NEXT_SANITY_CONFIG = `"use client";
-
-import { defineConfig } from "sanity";
-import { presentationTool } from "sanity/presentation";
-import { structureTool } from "sanity/structure";
-import { locations, mainDocuments } from "./sanity/presentation";
-import { schemaTypes } from "./sanity/schema/index";
-import { singletonActions, singletonTypes, structure } from "./sanity/structure";
-
-export default defineConfig({
-  name: "default",
-  title: "Studio",
-  basePath: "/studio",
-  projectId: process.env.NEXT_PUBLIC_SANITY_PROJECT_ID || "placeholder",
-  dataset: process.env.NEXT_PUBLIC_SANITY_DATASET || "production",
-  plugins: [
-    presentationTool({
-      resolve: { mainDocuments, locations },
-      previewUrl: {
-        initial: "/",
-        previewMode: {
-          enable: "/api/draft-mode/enable",
-          // Presentation never calls this itself (documented as not yet implemented);
-          // editors leave draft mode via <DisableDraftMode/>, which links to the route.
-          disable: "/api/draft-mode/disable",
-        },
-      },
-    }),
-    structureTool({ structure }),
-  ],
-  schema: { types: schemaTypes },
-${DOCUMENT_GUARD}
-});
-`;
-  ASTRO_SANITY_CONFIG = `import { defineConfig } from "sanity";
-import { presentationTool } from "sanity/presentation";
-import { structureTool } from "sanity/structure";
-import { locations, mainDocuments } from "./sanity/presentation";
-import { schemaTypes } from "./sanity/schema/index";
-import { singletonActions, singletonTypes, structure } from "./sanity/structure";
-
-export default defineConfig({
-  name: "default",
-  title: "Studio",
-  projectId: import.meta.env.PUBLIC_SANITY_PROJECT_ID || "placeholder",
-  dataset: import.meta.env.PUBLIC_SANITY_DATASET || "production",
-  plugins: [
-    presentationTool({
-      resolve: { mainDocuments, locations },
-      // No previewMode: Astro has no draft-mode routes. Draft content comes from
-      // loadQuery's perspective switch (PUBLIC_SANITY_VISUAL_EDITING_ENABLED + token),
-      // which needs a rendering server — \`astro dev\`, or an SSR adapter in production.
-      previewUrl: { initial: "/" },
-    }),
-    structureTool({ structure }),
-  ],
-  schema: { types: schemaTypes },
-${DOCUMENT_GUARD}
-});
-`;
+  init_seed();
+  init_studio();
+  SANITY_PACKAGE_JSON = j6({
+    name: "@workspace/sanity",
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    exports: {
+      "./env": "./src/env.ts",
+      "./client": "./src/client.ts",
+      "./live": "./src/live.ts",
+      "./fetch": "./src/fetch.ts",
+      "./image": "./src/image.ts",
+      "./queries": "./src/queries.ts",
+      "./types": "./src/sanity.types.ts"
+    }
+  });
+  SANITY_BLOCKS_PACKAGE_JSON = j6({
+    name: "@workspace/sanity-blocks",
+    version: "0.0.0",
+    private: true,
+    type: "module",
+    exports: {
+      ".": "./src/schema.ts",
+      "./blocks": "./src/blocks.tsx",
+      "./PageBuilder.astro": "./src/PageBuilder.astro"
+    }
+  });
   sanity = {
     id: "sanity",
     kind: "content",
     prompt: {
       label: "Sanity",
-      hint: "Headless CMS with an embedded Studio (Next: /studio, Astro: /admin)"
+      hint: "Headless CMS with a Studio of its own (apps/studio)"
     },
     templates: [
-      { path: "apps/web/sanity/schema/blocks.ts", content: SCHEMA_BLOCKS },
-      { path: "apps/web/sanity/schema/page.ts", content: SCHEMA_PAGE },
-      { path: "apps/web/sanity/schema/settings.ts", content: SCHEMA_SETTINGS },
-      { path: "apps/web/sanity/schema/index.ts", content: SCHEMA_INDEX },
-      { path: "apps/web/sanity/structure.ts", content: STRUCTURE },
-      { path: "apps/web/sanity/presentation.ts", content: PRESENTATION },
-      { path: "apps/web/sanity/queries.ts", content: QUERIES },
-      { path: "apps/web/sanity/seed.ndjson", content: SEED_NDJSON }
+      { path: "packages/sanity/package.json", content: SANITY_PACKAGE_JSON },
+      { path: "packages/sanity/src/queries.ts", content: QUERIES },
+      { path: "packages/sanity/src/sanity.types.ts", content: SANITY_TYPES },
+      { path: "packages/sanity-blocks/package.json", content: SANITY_BLOCKS_PACKAGE_JSON },
+      { path: "packages/sanity-blocks/src/schema.ts", content: SCHEMA_BLOCKS },
+      { path: "apps/studio/package.json", content: STUDIO_PACKAGE_JSON },
+      { path: "apps/studio/tsconfig.json", content: STUDIO_TSCONFIG },
+      { path: "apps/studio/sanity.cli.ts", content: STUDIO_CLI },
+      { path: "apps/studio/schemaTypes/index.ts", content: SCHEMA_INDEX },
+      { path: "apps/studio/schemaTypes/definitions.ts", content: SCHEMA_DEFINITIONS },
+      { path: "apps/studio/schemaTypes/page.ts", content: SCHEMA_PAGE },
+      { path: "apps/studio/schemaTypes/blog.ts", content: SCHEMA_BLOG },
+      { path: "apps/studio/schemaTypes/settings.ts", content: SCHEMA_SETTINGS },
+      { path: "apps/studio/structure.ts", content: STRUCTURE },
+      { path: "apps/studio/presentation.ts", content: PRESENTATION },
+      { path: "apps/studio/seed.ndjson", content: SEED_NDJSON }
     ],
     fragments: {
       next: [
-        { path: "apps/web/sanity/env.ts", content: NEXT_ENV },
-        { path: "apps/web/sanity/client.ts", content: NEXT_CLIENT },
-        { path: "apps/web/sanity/live.ts", content: NEXT_LIVE },
-        { path: "apps/web/sanity/fetch.ts", content: NEXT_FETCH },
-        { path: "apps/web/sanity/image.ts", content: NEXT_IMAGE },
-        { path: "apps/web/sanity/page-builder.tsx", content: NEXT_PAGE_BUILDER },
+        { path: "packages/sanity/src/env.ts", content: NEXT_ENV },
+        { path: "packages/sanity/src/client.ts", content: NEXT_CLIENT },
+        { path: "packages/sanity/src/live.ts", content: NEXT_LIVE },
+        { path: "packages/sanity/src/fetch.ts", content: NEXT_FETCH },
+        { path: "packages/sanity/src/image.ts", content: NEXT_IMAGE },
+        { path: "packages/sanity-blocks/src/blocks.tsx", content: NEXT_PAGE_BUILDER },
+        { path: "apps/studio/sanity.config.ts", content: STUDIO_CONFIG_NEXT },
+        { path: "apps/studio/.env.example", content: STUDIO_ENV_EXAMPLE_NEXT },
         { path: "apps/web/sanity/disable-draft-mode.tsx", content: NEXT_DISABLE_DRAFT_MODE },
-        { path: "apps/web/sanity.config.ts", content: NEXT_SANITY_CONFIG },
-        { path: "apps/web/sanity.cli.ts", content: NEXT_SANITY_CLI },
-        { path: "apps/web/app/studio/[[...tool]]/page.tsx", content: NEXT_STUDIO_PAGE },
         { path: "apps/web/app/api/draft-mode/enable/route.ts", content: NEXT_DRAFT_MODE_ROUTE },
         {
           path: "apps/web/app/api/draft-mode/disable/route.ts",
           content: NEXT_DRAFT_MODE_DISABLE_ROUTE
         },
-        { path: "apps/web/app/[slug]/page.tsx", content: NEXT_SLUG_PAGE }
+        { path: "apps/web/app/[slug]/page.tsx", content: NEXT_SLUG_PAGE },
+        { path: "apps/web/app/blog/page.tsx", content: NEXT_BLOG_INDEX_PAGE },
+        { path: "apps/web/app/blog/[slug]/page.tsx", content: NEXT_BLOG_POST_PAGE }
       ],
       astro: [
-        { path: "apps/web/sanity/env.ts", content: ASTRO_ENV },
-        { path: "apps/web/sanity/fetch.ts", content: ASTRO_FETCH },
-        { path: "apps/web/sanity/image.ts", content: ASTRO_IMAGE },
-        { path: "apps/web/sanity/types.ts", content: ASTRO_TYPES },
-        { path: "apps/web/sanity.config.ts", content: ASTRO_SANITY_CONFIG },
-        { path: "apps/web/sanity.cli.ts", content: ASTRO_SANITY_CLI },
-        { path: "apps/web/src/components/PageBuilder.astro", content: ASTRO_PAGE_BUILDER },
-        { path: "apps/web/src/pages/[slug].astro", content: ASTRO_SLUG_PAGE }
+        { path: "packages/sanity/src/env.ts", content: ASTRO_ENV },
+        { path: "packages/sanity/src/fetch.ts", content: ASTRO_FETCH },
+        { path: "packages/sanity/src/image.ts", content: ASTRO_IMAGE },
+        { path: "packages/sanity-blocks/src/PageBuilder.astro", content: ASTRO_PAGE_BUILDER },
+        { path: "apps/studio/sanity.config.ts", content: STUDIO_CONFIG_ASTRO },
+        { path: "apps/studio/.env.example", content: STUDIO_ENV_EXAMPLE_ASTRO },
+        { path: "apps/web/src/pages/[slug].astro", content: ASTRO_SLUG_PAGE },
+        { path: "apps/web/src/pages/blog/index.astro", content: ASTRO_BLOG_INDEX_PAGE },
+        { path: "apps/web/src/pages/blog/[slug].astro", content: ASTRO_BLOG_POST_PAGE }
       ]
     },
+    scripts: {
+      "dev:studio": "turbo run dev --filter=studio",
+      "build:studio": "turbo run build --filter=studio"
+    },
     deps: [
-      { name: "groq", version: "^6.7.0", target: "app" }
+      { name: "@workspace/sanity", version: "workspace:*", target: "app" },
+      { name: "@workspace/sanity-blocks", version: "workspace:*", target: "app" },
+      { name: "groq", version: "^6.7.0", target: "sanity" },
+      { name: "@sanity/client", version: "^7.26.0", target: "sanity" },
+      { name: "sanity", version: "^5.31.1", target: "sanity-blocks" },
+      { name: "@workspace/sanity", version: "workspace:*", target: "sanity-blocks" }
     ],
     frontendDeps: {
       next: [
@@ -1759,59 +3823,40 @@ ${DOCUMENT_GUARD}
         { name: "@portabletext/react", version: "^7.0.1", target: "app" },
         { name: "@sanity/image-url", version: "^2.1.1", target: "app" },
         { name: "@sanity/client", version: "^7.26.0", target: "app" },
-        { name: "sanity", version: "^5.31.1", target: "app" },
-        { name: "styled-components", version: "^6.1", target: "app" }
+        { name: "next-sanity", version: "^13.2.3", target: "sanity" },
+        { name: "@sanity/image-url", version: "^2.1.1", target: "sanity" },
+        { name: "next", version: "^16.2.0", target: "sanity" },
+        { name: "@portabletext/react", version: "^7.0.1", target: "sanity-blocks" },
+        { name: "next", version: "^16.2.0", target: "sanity-blocks" },
+        { name: "react", version: "^19.0.0", target: "sanity-blocks" }
       ],
       astro: [
         { name: "@sanity/astro", version: "^3.5.0", target: "app" },
         { name: "astro-portabletext", version: "^0.13.0", target: "app" },
-        { name: "@portabletext/types", version: "^4.0.2", target: "app" },
         { name: "@sanity/image-url", version: "^2.1.1", target: "app" },
         { name: "@sanity/client", version: "^7.26.0", target: "app" },
-        { name: "sanity", version: "^5.31.1", target: "app" },
         { name: "@sanity/ui", version: "^3.5.1", target: "app" },
         { name: "react-compiler-runtime", version: "^1.0.0", target: "app" },
         { name: "react-is", version: "^19.0.0", target: "app" },
         { name: "lodash", version: "^4.17.21", target: "app" },
-        { name: "styled-components", version: "^6.1", target: "app" },
-        { name: "@types/node", version: "^22.10.0", target: "app", dev: true }
+        { name: "@sanity/image-url", version: "^2.1.1", target: "sanity" },
+        { name: "astro-portabletext", version: "^0.13.0", target: "sanity-blocks" }
       ]
     },
     env: [
       { key: "NEXT_PUBLIC_SANITY_PROJECT_ID", scope: "client" },
       { key: "NEXT_PUBLIC_SANITY_DATASET", scope: "client" },
       { key: "NEXT_PUBLIC_SANITY_API_VERSION", scope: "client" },
+      { key: "NEXT_PUBLIC_SANITY_STUDIO_URL", scope: "client" },
+      { key: "SANITY_STUDIO_PROJECT_ID", scope: "server" },
+      { key: "SANITY_STUDIO_DATASET", scope: "server" },
+      { key: "SANITY_STUDIO_PRESENTATION_URL", scope: "server" },
       { key: "SANITY_API_READ_TOKEN", scope: "server" },
       { key: "PUBLIC_SANITY_PROJECT_ID", scope: "client" },
       { key: "PUBLIC_SANITY_DATASET", scope: "client" },
+      { key: "PUBLIC_SANITY_STUDIO_URL", scope: "client" },
       { key: "PUBLIC_SANITY_VISUAL_EDITING_ENABLED", scope: "client" }
     ],
-    owns: [
-      "apps/web/sanity/schema/blocks.ts",
-      "apps/web/sanity/schema/page.ts",
-      "apps/web/sanity/schema/settings.ts",
-      "apps/web/sanity/schema/index.ts",
-      "apps/web/sanity/structure.ts",
-      "apps/web/sanity/presentation.ts",
-      "apps/web/sanity/queries.ts",
-      "apps/web/sanity/seed.ndjson",
-      "apps/web/sanity/env.ts",
-      "apps/web/sanity/client.ts",
-      "apps/web/sanity/live.ts",
-      "apps/web/sanity/fetch.ts",
-      "apps/web/sanity/image.ts",
-      "apps/web/sanity/types.ts",
-      "apps/web/sanity/page-builder.tsx",
-      "apps/web/sanity/disable-draft-mode.tsx",
-      "apps/web/sanity.config.ts",
-      "apps/web/sanity.cli.ts",
-      "apps/web/app/studio/[[...tool]]/page.tsx",
-      "apps/web/app/api/draft-mode/enable/route.ts",
-      "apps/web/app/api/draft-mode/disable/route.ts",
-      "apps/web/app/[slug]/page.tsx",
-      "apps/web/src/components/PageBuilder.astro",
-      "apps/web/src/pages/[slug].astro"
-    ],
     patches: [
       {
         path: "apps/web/next.config.ts",
@@ -1821,14 +3866,13 @@ ${DOCUMENT_GUARD}
       { path: "apps/web/app/page.tsx", apply: replaceHomePage(NEXT_HOME_PAGE) },
       {
         path: "apps/web/astro.config.mjs",
-        apply: (content) => addAstroOptimizeDeps(addAstroIntegration(prependAstroConfigStatement(content, ASTRO_ENV_LOADER, "process.loadEnvFile"), 'import sanity from "@sanity/astro";', `sanity({ projectId: process.env.PUBLIC_SANITY_PROJECT_ID ?? 'placeholder', dataset: process.env.PUBLIC_SANITY_DATASET ?? 'production', apiVersion: '2026-02-01', useCdn: false, studioBasePath: '/admin', stega: { studioUrl: '/admin' } })`))
+        apply: (content) => addAstroOptimizeDeps(addAstroIntegration(prependAstroConfigStatement(content, ASTRO_ENV_LOADER, "process.loadEnvFile"), 'import sanity from "@sanity/astro";', `sanity({ projectId: process.env.PUBLIC_SANITY_PROJECT_ID ?? 'placeholder', dataset: process.env.PUBLIC_SANITY_DATASET ?? 'production', apiVersion: '2026-02-01', useCdn: false, stega: { studioUrl: process.env.PUBLIC_SANITY_STUDIO_URL ?? 'http://localhost:3333' } })`))
       },
       {
         path: "apps/web/src/env.d.ts",
         apply: (content) => ensureImport(content, ASTRO_MODULE_REF)
       },
       { path: "apps/web/src/pages/index.astro", apply: patchAstroIndex },
-      { path: "apps/web/package.json", apply: patchWebPackageJson },
       {
         path: "README.md",
         apply: (content) => content.includes("## Sanity") ? content : content + README_SECTION
@@ -1838,7 +3882,7 @@ ${DOCUMENT_GUARD}
 });
 
 // ../../packages/registry/src/frontends/astro.ts
-var j4 = (value) => `${JSON.stringify(value, null, 2)}
+var j7 = (value) => `${JSON.stringify(value, null, 2)}
 `, ASTRO_CONFIG = `import react from "@astrojs/react";
 import { defineConfig } from "astro/config";
 
@@ -1868,10 +3912,14 @@ var init_astro = __esm(() => {
   astroFrontend = {
     id: "astro",
     kind: "frontend",
+    prompt: {
+      label: "Astro",
+      hint: "Islands architecture, zero client JS by default"
+    },
     templates: [
       {
         path: "apps/web/package.json",
-        content: j4({
+        content: j7({
           name: "web",
           version: "0.0.0",
           private: true,
@@ -1903,7 +3951,7 @@ var init_astro = __esm(() => {
       { path: "apps/web/astro.config.mjs", content: ASTRO_CONFIG },
       {
         path: "apps/web/tsconfig.json",
-        content: j4({
+        content: j7({
           extends: "astro/tsconfigs/strict",
           compilerOptions: { jsx: "react-jsx", jsxImportSource: "react" },
           include: [".astro/types.d.ts", "**/*"],
@@ -1913,17 +3961,44 @@ var init_astro = __esm(() => {
       { path: "apps/web/src/env.d.ts", content: `/// <reference types="astro/client" />
 ` },
       { path: "apps/web/src/pages/index.astro", content: INDEX_ASTRO }
-    ],
-    owns: [
-      "apps/web/package.json",
-      "apps/web/astro.config.mjs",
-      "apps/web/tsconfig.json",
-      "apps/web/src/env.d.ts",
-      "apps/web/src/pages/index.astro"
     ]
   };
 });
 
+// ../../packages/registry/src/frontends/deploy-target.ts
+var ASTRO_SSR_MODULES, ASTROJS_VERCEL_VERSION = "^9.0.5", NODE_IMPORT = 'import node from "@astrojs/node";', NODE_ADAPTER = 'node({ mode: "standalone" })', VERCEL_IMPORT = 'import vercel from "@astrojs/vercel";', VERCEL_ADAPTER = "vercel()", deployDescriptor = (config) => {
+  if (config.frontend !== "astro" || config.deploy !== "vercel")
+    return null;
+  if (!config.modules.some((id) => ASTRO_SSR_MODULES.includes(id)))
+    return null;
+  return {
+    id: "deploy-vercel",
+    kind: "frontend",
+    frontendDeps: {
+      astro: [{ name: "@astrojs/vercel", version: ASTROJS_VERCEL_VERSION, target: "app" }]
+    },
+    patches: [
+      {
+        path: "apps/web/astro.config.mjs",
+        apply: (content) => {
+          if (content.includes(VERCEL_IMPORT))
+            return content;
+          if (!content.includes(NODE_IMPORT))
+            return content;
+          return content.replace(NODE_IMPORT, VERCEL_IMPORT).replace(NODE_ADAPTER, VERCEL_ADAPTER);
+        }
+      },
+      {
+        path: "apps/web/package.json",
+        apply: (content) => content.includes('"@astrojs/node"') ? content.replace(/^\s*"@astrojs\/node":\s*"[^"]*",?\n/m, "") : content
+      }
+    ]
+  };
+};
+var init_deploy_target = __esm(() => {
+  ASTRO_SSR_MODULES = ["forms"];
+});
+
 // ../../packages/registry/src/frontends/experimental.ts
 var BABEL_REACT_COMPILER_VERSION = "^1.0.0", experimentalDescriptor = (config) => {
   const { cacheComponents, reactCompiler } = config.experimental;
@@ -1960,7 +4035,7 @@ var BABEL_REACT_COMPILER_VERSION = "^1.0.0", experimentalDescriptor = (config) =
 var init_experimental = () => {};
 
 // ../../packages/registry/src/frontends/next.ts
-var j5 = (value) => `${JSON.stringify(value, null, 2)}
+var j8 = (value) => `${JSON.stringify(value, null, 2)}
 `, NEXT_CONFIG = `import { createRequire } from "node:module";
 import type { NextConfig } from "next";
 
@@ -2016,10 +4091,14 @@ var init_next = __esm(() => {
   nextFrontend = {
     id: "next",
     kind: "frontend",
+    prompt: {
+      label: "Next.js",
+      hint: "App Router, React Server Components, Turbopack"
+    },
     templates: [
       {
         path: "apps/web/package.json",
-        content: j5({
+        content: j8({
           name: "web",
           version: "0.0.0",
           private: true,
@@ -2050,7 +4129,7 @@ var init_next = __esm(() => {
       { path: "apps/web/next.config.ts", content: NEXT_CONFIG },
       {
         path: "apps/web/tsconfig.json",
-        content: j5({
+        content: j8({
           extends: "@workspace/typescript-config/nextjs.json",
           compilerOptions: { plugins: [{ name: "next" }], paths: { "@/*": ["./*"] } },
           include: ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
@@ -2060,14 +4139,6 @@ var init_next = __esm(() => {
       { path: "apps/web/app/layout.tsx", content: LAYOUT },
       { path: "apps/web/app/page.tsx", content: PAGE },
       { path: "apps/web/app/globals.css", content: GLOBALS }
-    ],
-    owns: [
-      "apps/web/package.json",
-      "apps/web/next.config.ts",
-      "apps/web/tsconfig.json",
-      "apps/web/app/layout.tsx",
-      "apps/web/app/page.tsx",
-      "apps/web/app/globals.css"
     ]
   };
 });
@@ -2236,18 +4307,12 @@ export default function AlgoliaSearch({
       { key: "PUBLIC_ALGOLIA_APP_ID", scope: "client" },
       { key: "PUBLIC_ALGOLIA_SEARCH_KEY", scope: "client" },
       { key: "PUBLIC_ALGOLIA_INDEX", scope: "client" }
-    ],
-    owns: [
-      "apps/web/app/search/Search.tsx",
-      "apps/web/app/search/page.tsx",
-      "apps/web/src/components/AlgoliaSearch.tsx",
-      "apps/web/src/pages/search.astro"
     ]
   };
 });
 
 // ../../packages/registry/src/modules/changesets.ts
-var j6 = (v) => `${JSON.stringify(v, null, 2)}
+var j9 = (v) => `${JSON.stringify(v, null, 2)}
 `, CONFIG, README = `# Changesets
 
 This folder is managed by [Changesets](https://github.com/changesets/changesets).
@@ -2258,7 +4323,7 @@ the \`version-packages\` script consumes them to update versions and changelogs,
 the \`release\` script builds and publishes.
 `, changesets;
 var init_changesets = __esm(() => {
-  CONFIG = j6({
+  CONFIG = j9({
     $schema: "https://unpkg.com/@changesets/config@3.1.4/schema.json",
     changelog: "@changesets/cli/changelog",
     commit: false,
@@ -2286,8 +4351,7 @@ var init_changesets = __esm(() => {
       changeset: "changeset",
       "version-packages": "changeset version",
       release: "turbo run build && changeset publish"
-    },
-    owns: [".changeset/config.json", ".changeset/README.md"]
+    }
   };
 });
 
@@ -2336,8 +4400,7 @@ var init_e2e = __esm(() => {
       ]
     },
     scripts: { e2e: "playwright test" },
-    deps: [{ name: "@playwright/test", version: "^1.60.0", target: "root", dev: true }],
-    owns: ["tests/e2e/home.spec.ts", "playwright.config.ts"]
+    deps: [{ name: "@playwright/test", version: "^1.60.0", target: "root", dev: true }]
   };
 });
 
@@ -2577,13 +4640,6 @@ export const POST: APIRoute = async ({ request }) => {
         path: "apps/web/astro.config.mjs",
         apply: (content) => ensureAstroAdapter(content, 'import node from "@astrojs/node";', 'node({ mode: "standalone" })')
       }
-    ],
-    owns: [
-      "apps/web/app/contact/page.tsx",
-      "apps/web/app/api/contact/route.ts",
-      "apps/web/src/components/ContactForm.tsx",
-      "apps/web/src/pages/contact.astro",
-      "apps/web/src/pages/api/contact.ts"
     ]
   };
 });
@@ -2625,8 +4681,7 @@ var init_git_hooks = __esm(() => {
         target: "root",
         dev: true
       }
-    ],
-    owns: ["lefthook.yml", "commitlint.config.mjs"]
+    ]
   };
 });
 
@@ -2680,8 +4735,7 @@ var init_github_ci = __esm(() => {
       label: "GitHub Actions CI",
       hint: "Workflow that installs, type-checks, and builds on every push and PR."
     },
-    templates: [{ path: ".github/workflows/ci.yml", content: CI_WORKFLOW }],
-    owns: [".github/workflows/ci.yml"]
+    templates: [{ path: ".github/workflows/ci.yml", content: CI_WORKFLOW }]
   };
 });
 
@@ -2844,18 +4898,7 @@ ${LLMS_TXT_REST}\`;
         { path: "apps/web/src/content/pages.ts", content: ASTRO_CONTENT },
         { path: "apps/web/src/pages/[slug].md.ts", content: ASTRO_MD_ENDPOINT }
       ]
-    },
-    owns: [
-      "skills.md",
-      "apps/web/app/llms.txt/route.ts",
-      "apps/web/app/docs/content.ts",
-      "apps/web/app/docs/page.tsx",
-      "apps/web/app/docs.md/route.ts",
-      "apps/web/app/lib/markdown-variant.ts",
-      "apps/web/src/pages/llms.txt.ts",
-      "apps/web/src/content/pages.ts",
-      "apps/web/src/pages/[slug].md.ts"
-    ]
+    }
   };
 });
 
@@ -2916,7 +4959,6 @@ var init_posthog = __esm(() => {
       { key: "PUBLIC_POSTHOG_KEY", scope: "client" },
       { key: "PUBLIC_POSTHOG_HOST", scope: "client" }
     ],
-    owns: ["apps/web/instrumentation-client.ts", "apps/web/src/components/PostHog.astro"],
     patches: [
       { path: "apps/web/src/pages/index.astro", apply: patchIndexAstro },
       { path: "apps/web/src/layouts/Layout.astro", apply: patchIndexAstro }
@@ -3444,15 +5486,6 @@ var init_sections = __esm(() => {
       { path: "packages/ui/src/components/sections/faq.tsx", content: FAQ_TSX },
       { path: "packages/ui/src/components/sections/cta.tsx", content: CTA_TSX }
     ],
-    owns: [
-      "packages/ui/src/components/sections/hero.tsx",
-      "packages/ui/src/components/sections/features.tsx",
-      "packages/ui/src/components/sections/logo-cloud.tsx",
-      "packages/ui/src/components/sections/testimonials.tsx",
-      "packages/ui/src/components/sections/pricing.tsx",
-      "packages/ui/src/components/sections/faq.tsx",
-      "packages/ui/src/components/sections/cta.tsx"
-    ],
     patches: [
       { path: "apps/web/app/page.tsx", apply: replaceWith(COMPOSED_NEXT_HOME_PAGE) },
       { path: "apps/web/src/pages/index.astro", apply: replaceWith(COMPOSED_ASTRO_HOME_PAGE) }
@@ -3720,14 +5753,6 @@ var init_seo = __esm(() => {
       { key: "PUBLIC_SITE_NAME", scope: "client" },
       { key: "PUBLIC_SITE_DESCRIPTION", scope: "client" }
     ],
-    owns: [
-      "apps/web/app/lib/metadata.ts",
-      "apps/web/app/sitemap.ts",
-      "apps/web/app/robots.ts",
-      "apps/web/app/opengraph-image.tsx",
-      "apps/web/src/components/SEO.astro",
-      "apps/web/src/pages/og.png.ts"
-    ],
     patches: [
       { path: "apps/web/astro.config.mjs", apply: patchAstroConfig },
       { path: "apps/web/app/layout.tsx", apply: patchLayout },
@@ -4048,7 +6073,7 @@ export function SiteHeader({
           ))}
         </nav>
         <div className="ml-auto">
-          <Button size="sm" render={<a href={action.href} />}>
+          <Button size="sm" nativeButton={false} render={<a href={action.href} />}>
             {action.label}
           </Button>
         </div>
@@ -4111,7 +6136,9 @@ export default function NotFound() {
       <p className="text-muted-foreground">
         The link may be out of date, or the page may have moved.
       </p>
-      <Button render={<a href="/" />}>Back home</Button>
+      <Button nativeButton={false} render={<a href="/" />}>
+        Back home
+      </Button>
     </main>
   );
 }
@@ -4562,8 +6589,8 @@ ${DARK_TOKENS}
 });
 
 // ../../packages/registry/src/modules/ui/index.ts
-var j7 = (value) => `${JSON.stringify(value, null, 2)}
-`, UI_PACKAGE_JSON, componentsJson = (rsc) => j7({
+var j10 = (value) => `${JSON.stringify(value, null, 2)}
+`, UI_PACKAGE_JSON, componentsJson = (rsc) => j10({
   $schema: "https://ui.shadcn.com/schema.json",
   style: "base-nova",
   rsc,
@@ -4586,20 +6613,22 @@ var j7 = (value) => `${JSON.stringify(value, null, 2)}
   menuColor: "default",
   menuAccent: "subtle"
 }), patchNextLayout2 = (content) => {
-  if (content.includes("@workspace/ui/components/site-header"))
+  if (content.includes("<SiteHeader"))
     return content;
   const withImports = [
     'import { SiteFooter } from "@workspace/ui/components/site-footer";',
     'import { SiteHeader } from "@workspace/ui/components/site-header";',
-    'import rootPkg from "../../../package.json";',
-    content
+    'import rootPkg from "../../../package.json";'
+  ].reduce(ensureImport, content);
+  const expanded = withImports.replace(/^([ \t]*)<body([^>]*)>\{children\}<\/body>/m, (_m, indent, attrs) => `${indent}<body${attrs}>
+${indent}  {children}
+${indent}</body>`);
+  return expanded.replace(/<body([^>]*)>/, '<body$1 className="flex min-h-svh flex-col">').replace(/^([ \t]*)\{children\}$/m, (_m, indent) => [
+    `${indent}<SiteHeader siteName={rootPkg.name} />`,
+    `${indent}<div className="flex-1">{children}</div>`,
+    `${indent}<SiteFooter siteName={rootPkg.name} />`
   ].join(`
-`);
-  return withImports.replace(/<body([^>]*)>\{children\}<\/body>/, `<body$1 className="flex min-h-svh flex-col">
-        <SiteHeader siteName={rootPkg.name} />
-        <div className="flex-1">{children}</div>
-        <SiteFooter siteName={rootPkg.name} />
-      </body>`);
+`));
 }, NEXT_POSTCSS_CONFIG = `export default {
   plugins: {
     "@tailwindcss/postcss": {},
@@ -4610,7 +6639,7 @@ var j7 = (value) => `${JSON.stringify(value, null, 2)}
 var init_ui = __esm(() => {
   init_pages();
   init_theme();
-  UI_PACKAGE_JSON = j7({
+  UI_PACKAGE_JSON = j10({
     name: "@workspace/ui",
     version: "0.0.0",
     private: true,
@@ -4674,25 +6703,6 @@ var init_ui = __esm(() => {
       ]
     },
     deps: [{ name: "@workspace/ui", version: "workspace:*", target: "app" }],
-    owns: [
-      "packages/ui/package.json",
-      "packages/ui/components.json",
-      "packages/ui/src/styles/globals.css",
-      "packages/ui/src/lib/utils.ts",
-      "packages/ui/src/components/button.tsx",
-      "packages/ui/src/components/card.tsx",
-      "packages/ui/src/components/input.tsx",
-      "packages/ui/src/components/textarea.tsx",
-      "packages/ui/src/components/label.tsx",
-      "packages/ui/src/components/badge.tsx",
-      "packages/ui/src/components/site-header.tsx",
-      "packages/ui/src/components/site-footer.tsx",
-      "apps/web/postcss.config.mjs",
-      "apps/web/components.json",
-      "apps/web/app/not-found.tsx",
-      "apps/web/src/layouts/Layout.astro",
-      "apps/web/src/pages/404.astro"
-    ],
     patches: [
       {
         path: "apps/web/app/globals.css",
@@ -4710,7 +6720,7 @@ var init_ui = __esm(() => {
           if (!plugin || pkg.devDependencies?.[plugin])
             return content;
           const devDependencies = Object.fromEntries(Object.entries({ ...pkg.devDependencies, [plugin]: "^4.3.0" }).sort(([a], [b]) => a.localeCompare(b)));
-          return j7({ ...pkg, devDependencies });
+          return j10({ ...pkg, devDependencies });
         }
       },
       { path: "apps/web/app/layout.tsx", apply: patchNextLayout2 },
@@ -4751,21 +6761,51 @@ var init_vitest = __esm(() => {
       { path: "tests/example.test.ts", content: EXAMPLE_TEST }
     ],
     scripts: { test: "vitest run", "test:watch": "vitest" },
-    deps: [{ name: "vitest", version: "^4.1.0", target: "root", dev: true }],
-    owns: ["vitest.config.ts", "tests/example.test.ts"]
+    deps: [{ name: "vitest", version: "^4.1.0", target: "root", dev: true }]
   };
 });
 
+// ../../packages/registry/src/catalog.ts
+function withPrerequisites(selected) {
+  const chosen = new Set(selected);
+  const added = [];
+  const queue = [...selected];
+  for (const id of queue) {
+    for (const required of MODULE_DESCRIPTORS[id]?.compat?.requiresModules ?? []) {
+      if (chosen.has(required))
+        continue;
+      chosen.add(required);
+      added.push([required, id]);
+      queue.push(required);
+    }
+  }
+  return { modules: MODULES.filter((id) => chosen.has(id)), added };
+}
+var entry = (id, descriptor) => ({
+  id,
+  label: descriptor?.prompt?.label ?? id,
+  hint: descriptor?.prompt?.hint ?? "",
+  category: descriptor?.category,
+  requires: descriptor?.compat?.requiresModules ?? []
+}), moduleCatalog = () => MODULES.map((id) => entry(id, MODULE_DESCRIPTORS[id])), frontendCatalog = () => FRONTENDS.map((id) => entry(id, FRONTEND_DESCRIPTORS[id])), NO_CONTENT, contentCatalog = () => CONTENT_SOURCES.map((id) => id === "none" ? { id, ...NO_CONTENT, category: undefined, requires: [] } : entry(id, CONTENT_DESCRIPTORS[id]));
+var init_catalog = __esm(() => {
+  init_src();
+  init_src3();
+  NO_CONTENT = { label: "None", hint: "No CMS and no MDX — just the frontend" };
+});
+
 // ../../packages/registry/src/index.ts
 function buildRegistry(config2) {
   const content = CONTENT_DESCRIPTORS[config2.content];
   const experimental = experimentalDescriptor(config2);
+  const deploy = deployDescriptor(config2);
   return [
     ...baselineDescriptors,
     FRONTEND_DESCRIPTORS[config2.frontend],
     ...experimental ? [experimental] : [],
     ...content ? [content] : [],
-    ...config2.modules.map((id) => MODULE_DESCRIPTORS[id])
+    ...config2.modules.map((id) => MODULE_DESCRIPTORS[id]),
+    ...deploy ? [deploy] : []
   ];
 }
 var baselineDescriptors, FRONTEND_DESCRIPTORS, MODULE_DESCRIPTORS, CONTENT_DESCRIPTORS;
@@ -4777,6 +6817,7 @@ var init_src3 = __esm(() => {
   init_markdown();
   init_sanity();
   init_astro();
+  init_deploy_target();
   init_experimental();
   init_next();
   init_algolia();
@@ -4791,6 +6832,7 @@ var init_src3 = __esm(() => {
   init_seo();
   init_ui();
   init_vitest();
+  init_catalog();
   baselineDescriptors = [typescriptConfig, env, logger, biome];
   FRONTEND_DESCRIPTORS = {
     next: nextFrontend,
@@ -4817,40 +6859,82 @@ var init_src3 = __esm(() => {
 });
 
 // src/create.ts
-import { spawnSync } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import { mkdir as mkdir2 } from "node:fs/promises";
 import { resolve } from "node:path";
-function step(label, cmd, args, cwd, stdio = "ignore") {
+function step(label, cmd, args, cwd, stdio = "ignore", onWarn = warn) {
   const res = spawnSync(cmd, args, { cwd, stdio });
   if (res.error) {
-    console.error(`! ${label} skipped: ${res.error.message}`);
+    onWarn(`${label} skipped: ${res.error.message}`);
     return false;
   }
   if (res.status !== 0) {
-    console.error(`! ${label} failed (exit ${res.status ?? `signal ${res.signal}`})`);
+    onWarn(`${label} failed (exit ${res.status ?? `signal ${res.signal}`})`);
     return false;
   }
   return true;
 }
-async function createProject(config2, opts = {}) {
-  const res = generate(config2, buildRegistry(config2));
-  if (!res.ok)
-    return res;
+function streamStep(label, cmd, args, cwd, onOutput, onWarn) {
+  return new Promise((done) => {
+    const child = spawn(cmd, args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
+    const emit = (chunk) => {
+      for (const line of chunk.toString().split(/\r?\n|\r/)) {
+        if (line.trim())
+          onOutput(line);
+      }
+    };
+    child.stdout?.on("data", emit);
+    child.stderr?.on("data", emit);
+    child.on("error", (error) => {
+      onWarn(`${label} skipped: ${error.message}`);
+      done(false);
+    });
+    child.on("close", (code, signal) => {
+      if (code === 0)
+        return done(true);
+      onWarn(`${label} failed (exit ${code ?? `signal ${signal}`})`);
+      done(false);
+    });
+  });
+}
+function planProject(config2) {
+  return generate(config2, buildRegistry(config2));
+}
+async function writeProject(tree, config2, opts = {}) {
+  const { onWarn = warn, onOutput } = opts;
   const dir = resolve(opts.targetDir ?? config2.name);
   await mkdir2(dir, { recursive: true });
-  await writeTree(res.value, dir);
+  await writeTree(tree, dir);
   if (opts.git) {
-    const inited = step("git init", "git", ["init", "-q"], dir);
-    const added = inited && step("git add", "git", ["add", "-A"], dir);
+    const inited = step("git init", "git", ["init", "-q"], dir, "ignore", onWarn);
+    const added = inited && step("git add", "git", ["add", "-A"], dir, "ignore", onWarn);
     if (added) {
-      step("git commit", "git", ["commit", "-qm", "chore: scaffold with create-turbo-wizard"], dir);
+      const args = ["commit", "-qm", "chore: scaffold with create-turbo-wizard"];
+      step("git commit", "git", args, dir, "ignore", onWarn);
     }
   }
+  let installError;
   if (opts.install) {
-    step(`${config2.packageManager} install`, config2.packageManager, ["install"], dir, "inherit");
+    const label = `${config2.packageManager} install`;
+    const capture = (message) => {
+      installError = message;
+    };
+    const ok2 = onOutput ? await streamStep(label, config2.packageManager, ["install"], dir, onOutput, capture) : step(label, config2.packageManager, ["install"], dir, "inherit", capture);
+    if (ok2)
+      installError = null;
   }
-  return { ok: true, value: { dir, fileCount: res.value.size } };
+  return { dir, fileCount: tree.size, installError };
+}
+async function createProject(config2, opts = {}) {
+  const res = planProject(config2);
+  if (!res.ok)
+    return res;
+  const value = await writeProject(res.value, config2, opts);
+  if (value.installError)
+    (opts.onWarn ?? warn)(value.installError);
+  return { ok: true, value };
 }
+var warn = (message) => console.error(`! ${message}`);
 var init_create = __esm(() => {
   init_src2();
   init_src3();
@@ -4860,7 +6944,7 @@ var init_create = __esm(() => {
 var exports_mcp = {};
 __export(exports_mcp, {
   startMcpServer: () => startMcpServer,
-  planProject: () => planProject,
+  planProject: () => planProject2,
   guidanceText: () => guidanceText,
   createProjectFromInput: () => createProjectFromInput,
   buildMcpServer: () => buildMcpServer
@@ -4868,7 +6952,7 @@ __export(exports_mcp, {
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z as z3 } from "zod";
-function planProject(input) {
+function planProject2(input) {
   const config2 = toConfig(input);
   const res = generate(config2, buildRegistry(config2));
   if (!res.ok)
@@ -4886,7 +6970,7 @@ function buildMcpServer() {
     description: "Preview the files a configuration would generate (does NOT write to disk).",
     inputSchema: PlanInput
   }, (input) => {
-    const res = planProject(input);
+    const res = planProject2(input);
     return res.ok ? text2(res.paths.join(`
 `)) : { ...text2(`Generation failed: ${res.error}`), isError: true };
   });
@@ -4943,59 +7027,259 @@ var init_mcp = __esm(() => {
 init_src();
 init_package();
 init_create();
+import { resolve as resolve2 } from "node:path";
+import { cancel as cancel3, confirm, isCancel, log as log3 } from "@clack/prompts";
 import { initTRPC } from "@trpc/server";
 import { createCli } from "trpc-cli";
 import { z as z2 } from "zod";
 
 // src/prompts.ts
+init_src3();
 init_src();
-import { cancel, intro, isCancel, multiselect, outro, select, text } from "@clack/prompts";
-var orCancel = (value) => {
-  if (isCancel(value)) {
-    cancel("Cancelled.");
-    process.exit(0);
+import { cancel, group, groupMultiselect, log, select, text } from "@clack/prompts";
+
+// src/theme.ts
+import { WriteStream } from "node:tty";
+import { isCI, unicode } from "@clack/prompts";
+var resolveDepth = () => {
+  const stream = process.stdout;
+  if (typeof stream.getColorDepth === "function")
+    return stream.getColorDepth();
+  return process.env.FORCE_COLOR ? WriteStream.prototype.getColorDepth() : 1;
+};
+var depth = resolveDepth();
+var wrap = (open, close) => (value) => `\x1B[${open}m${value}\x1B[${close}m`;
+var plain = (value) => value;
+var scale = (rgb, x256, basic) => {
+  if (depth >= 24)
+    return wrap(`38;2;${rgb[0]};${rgb[1]};${rgb[2]}`, "39");
+  if (depth >= 8)
+    return wrap(`38;5;${x256}`, "39");
+  if (depth >= 4)
+    return wrap(String(basic), "39");
+  return plain;
+};
+var effect = (open, close) => depth >= 4 ? wrap(open, close) : plain;
+var accent = scale([124, 140, 255], 105, 36);
+var accentDim = scale([74, 85, 168], 61, 34);
+var muted = scale([153, 161, 179], 109, 90);
+var success = scale([74, 222, 128], 78, 32);
+var warn2 = scale([251, 191, 36], 214, 33);
+var danger = scale([248, 113, 113], 203, 31);
+var bold = effect("1", "22");
+var dim = effect("2", "22");
+var badge = (value) => depth >= 24 ? `\x1B[48;2;124;140;255m\x1B[30m ${value} \x1B[39m\x1B[49m` : depth >= 8 ? `\x1B[48;5;105m\x1B[30m ${value} \x1B[39m\x1B[49m` : depth >= 4 ? `\x1B[46m\x1B[30m ${value} \x1B[39m\x1B[49m` : ` ${value} `;
+var WORDMARK = [
+  "████████╗██╗    ██╗██╗███████╗",
+  "╚══██╔══╝██║    ██║██║╚══███╔╝",
+  "   ██║   ██║ █╗ ██║██║  ███╔╝ ",
+  "   ██║   ██║███╗██║██║ ███╔╝  ",
+  "   ██║   ╚███╔███╔╝██║███████╗",
+  "   ╚═╝    ╚══╝╚══╝ ╚═╝╚══════╝"
+];
+var WORDMARK_WIDTH = 30;
+var TAGLINE = "scaffold a Turborepo monorepo";
+var shade = (row) => (row.match(/█+|[^█]+/g) ?? []).map((run) => run.startsWith("█") ? accent(run) : accentDim(run)).join("");
+function banner(version) {
+  if (!process.stdout.isTTY || isCI() || !unicode)
+    return null;
+  const label = `v${version}`;
+  const gap = Math.max(2, WORDMARK_WIDTH - 2 - TAGLINE.length - label.length);
+  const width = Math.max(WORDMARK_WIDTH, 2 + TAGLINE.length + gap + label.length);
+  if ((process.stdout.columns ?? 80) < width + 2)
+    return null;
+  const footer = `  ${muted(TAGLINE)}${" ".repeat(gap)}${dim(label)}`;
+  return `
+${WORDMARK.map(shade).join(`
+`)}
+
+${footer}
+`;
+}
+
+// src/prompts.ts
+var toOption = (entry2) => ({
+  value: entry2.id,
+  label: entry2.label,
+  ...entry2.hint ? { hint: entry2.hint } : {}
+});
+var PACKAGE_MANAGER_HINTS = {
+  pnpm: "Strict node_modules, workspace: protocol",
+  bun: "Fastest install, workspace: protocol",
+  npm: "No workspace: protocol — deps are rewritten to *"
+};
+var DEPLOY_HINTS = {
+  node: "@astrojs/node — runs anywhere, and what `astro preview` serves",
+  vercel: "@astrojs/vercel — required once a server route deploys to Vercel"
+};
+var CATEGORY_LABELS = {
+  ui: "UI",
+  integration: "Integrations",
+  devtools: "Developer tooling",
+  "cross-cutting": "Cross-cutting"
+};
+var moduleGroups = () => {
+  const catalog = moduleCatalog();
+  const groups = {};
+  for (const category of MODULE_CATEGORIES) {
+    const entries = catalog.filter((entry2) => entry2.category === category);
+    if (entries.length)
+      groups[CATEGORY_LABELS[category]] = entries.map(toOption);
   }
-  return value;
+  return groups;
+};
+var bail = () => {
+  cancel("Cancelled.");
+  process.exit(0);
 };
 async function gatherConfig(flags) {
-  intro("create-turbo-wizard");
-  const name = flags.name ?? orCancel(await text({
-    message: "Project name",
-    placeholder: "my-app",
-    defaultValue: "my-app",
-    validate: (v) => /^[a-z0-9][a-z0-9._-]*$/.test(v || "my-app") ? undefined : "lowercase, digits, -._ only"
-  }));
-  const frontend = flags.frontend ?? orCancel(await select({
-    message: "Frontend framework",
-    options: [
-      { value: "next", label: "Next.js" },
-      { value: "astro", label: "Astro" }
-    ]
-  }));
-  const content = flags.content ?? orCancel(await select({
-    message: "Content source",
-    options: CONTENT_SOURCES.map((value) => ({ value, label: value }))
-  }));
-  const packageManager = flags.packageManager ?? orCancel(await select({
-    message: "Package manager",
-    options: PACKAGE_MANAGERS.map((value) => ({ value, label: value }))
-  }));
-  const modules = flags.modules ?? orCancel(await multiselect({
-    message: "Optional modules (space to toggle)",
-    options: MODULES.map((value) => ({ value, label: value })),
-    required: false
-  }));
-  outro(`Scaffolding ${name} (${frontend} · ${content} · ${packageManager})`);
+  const answers = await group({
+    name: () => flags.name ? Promise.resolve(flags.name) : text({
+      message: "Project name",
+      placeholder: "my-app",
+      defaultValue: "my-app",
+      validate: (value) => {
+        const parsed = ProjectNameSchema.safeParse(value || "my-app");
+        return parsed.success ? undefined : parsed.error.issues[0]?.message;
+      }
+    }),
+    frontend: () => flags.frontend ? Promise.resolve(flags.frontend) : select({
+      message: "Frontend framework",
+      options: frontendCatalog().map(toOption),
+      initialValue: "next"
+    }),
+    content: () => flags.content ? Promise.resolve(flags.content) : select({
+      message: "Content source",
+      options: contentCatalog().map(toOption)
+    }),
+    packageManager: () => flags.packageManager ? Promise.resolve(flags.packageManager) : select({
+      message: "Package manager",
+      options: PACKAGE_MANAGERS.map((value) => ({
+        value,
+        label: value,
+        hint: PACKAGE_MANAGER_HINTS[value]
+      }))
+    }),
+    deploy: ({ results }) => flags.deploy || results.frontend !== "astro" ? Promise.resolve(flags.deploy ?? "node") : select({
+      message: "Deploy target",
+      options: DEPLOY_TARGETS.map((value) => ({
+        value,
+        label: value,
+        hint: DEPLOY_HINTS[value]
+      }))
+    }),
+    modules: () => flags.modules ? Promise.resolve(flags.modules) : groupMultiselect({
+      message: `Modules ${muted("(space to toggle, enter to confirm)")}`,
+      options: moduleGroups(),
+      required: false
+    })
+  }, { onCancel: bail });
+  const picked = (answers.modules ?? []).filter((id) => MODULES.includes(id));
+  const resolved = flags.modules ? { modules: picked, added: [] } : withPrerequisites(picked);
+  for (const [module, requiredBy] of resolved.added) {
+    log.info(`Added ${accent(module)} — required by ${accent(requiredBy)}`);
+  }
   return WizardConfigSchema.parse({
-    name,
-    frontend,
-    content,
-    packageManager,
-    modules,
+    name: answers.name,
+    frontend: answers.frontend,
+    content: answers.content,
+    packageManager: answers.packageManager,
+    deploy: answers.deploy,
+    modules: resolved.modules,
     experimental: { cacheComponents: flags.cacheComponents, reactCompiler: flags.reactCompiler }
   });
 }
 
+// src/ui.ts
+init_src3();
+init_src();
+import { relative, sep } from "node:path";
+import { cancel as cancel2, intro, log as log2, note, outro, taskLog } from "@clack/prompts";
+var RAW = { format: (line) => line };
+function printBanner(version) {
+  const art = banner(version);
+  if (art)
+    process.stdout.write(`${art}
+`);
+}
+function start() {
+  intro(badge("create-turbo-wizard"));
+}
+function displayPath(dir) {
+  const rel = relative(process.cwd(), dir);
+  return rel && !rel.startsWith("..") && !rel.startsWith(sep) ? `./${rel}` : dir;
+}
+function shape(tree) {
+  const nested = new Map;
+  let rootFiles = 0;
+  for (const path of tree.keys()) {
+    const [top, second] = path.split("/");
+    if (!top)
+      continue;
+    if (second && (top === "apps" || top === "packages")) {
+      const names = nested.get(top) ?? new Set;
+      names.add(second);
+      nested.set(top, names);
+    } else if (!second) {
+      rootFiles += 1;
+    }
+  }
+  const parts = [...nested].sort(([a], [b]) => a.localeCompare(b)).map(([top, names]) => names.size > 3 ? `${names.size} ${top}` : `${top}/{${[...names].sort().join(", ")}}`);
+  if (rootFiles)
+    parts.push(`${rootFiles} root files`);
+  return parts.join("   ");
+}
+var labelOf = (entries, id) => entries.find((entry2) => entry2.id === id)?.label ?? id;
+var row = (label, value) => `${muted(label.padEnd(10))}${value}`;
+function summary(config2, tree, dir) {
+  const stack = [
+    labelOf(frontendCatalog(), config2.frontend),
+    labelOf(contentCatalog(), config2.content),
+    config2.packageManager
+  ].join(" · ");
+  note([
+    row("Directory", accent(displayPath(dir))),
+    row("Stack", stack),
+    row("Modules", config2.modules.length ? config2.modules.join(", ") : muted("none")),
+    row("Writing", `${tree.size} files   ${muted(shape(tree))}`),
+    "",
+    muted("Reproduce this with"),
+    dim(buildCommand(config2))
+  ].join(`
+`), "Summary", RAW);
+}
+function installLog(config2) {
+  const task = taskLog({
+    title: `Installing dependencies with ${config2.packageManager}`,
+    limit: 8
+  });
+  return {
+    onOutput: (line) => task.message(line, { raw: true }),
+    finish: (error) => error ? task.error(error, { showLog: true }) : task.success(`${config2.packageManager} install`)
+  };
+}
+var runScript = (config2, script) => config2.packageManager === "npm" ? `npm run ${script}` : `${config2.packageManager} ${script}`;
+function nextSteps(config2, tree, dir, installed) {
+  const commands = [`cd ${displayPath(dir)}`];
+  if (!installed)
+    commands.push(`${config2.packageManager} install`);
+  commands.push(runScript(config2, "dev"));
+  if (config2.content === "sanity")
+    commands.push(runScript(config2, "dev:studio"));
+  const extras = [];
+  if (tree.has(".env.example"))
+    extras.push(row("Env", "copy .env.example to .env and fill it in"));
+  extras.push(row("Docs", "https://turbo-wizard.vercel.app/docs"));
+  note([...commands.map(accent), "", ...extras].join(`
+`), "Next steps", RAW);
+  outro(success(`Created ${config2.name} — ${tree.size} files`));
+}
+function fail(message) {
+  log2.error(message);
+  cancel2("Nothing was written.");
+  process.exit(1);
+}
+
 // src/router.ts
 var t = initTRPC.create();
 var CreateInput = z2.object({
@@ -5003,6 +7287,7 @@ var CreateInput = z2.object({
   frontend: z2.enum(FRONTENDS).optional(),
   content: z2.enum(CONTENT_SOURCES).optional(),
   packageManager: z2.enum(PACKAGE_MANAGERS).optional(),
+  deploy: z2.enum(DEPLOY_TARGETS).optional(),
   modules: z2.array(z2.enum(MODULES)).optional(),
   preset: z2.enum(PRESETS).optional(),
   cacheComponents: z2.boolean().optional(),
@@ -5020,33 +7305,48 @@ var router = t.router({
       frontend: input.frontend,
       content: input.content ?? base.content,
       packageManager: input.packageManager ?? base.packageManager,
+      deploy: input.deploy ?? base.deploy,
       modules: input.modules ?? base.modules,
       cacheComponents: input.cacheComponents ?? base.experimental?.cacheComponents,
       reactCompiler: input.reactCompiler ?? base.experimental?.reactCompiler
     };
+    printBanner(package_default.version);
+    start();
     const interactive = !input.yes && !input.preset && Boolean(process.stdout.isTTY) && (!input.frontend || !input.name);
     const config2 = interactive ? await gatherConfig(flags) : WizardConfigSchema.parse({
       name: flags.name ?? "my-app",
       frontend: flags.frontend ?? "next",
       content: flags.content,
       packageManager: flags.packageManager,
+      deploy: flags.deploy,
       modules: flags.modules,
       experimental: {
         cacheComponents: flags.cacheComponents,
         reactCompiler: flags.reactCompiler
       }
     });
-    const res = await createProject(config2, {
-      targetDir: input.dir,
+    const plan = planProject(config2);
+    if (!plan.ok)
+      fail(plan.error.message);
+    const dir = resolve2(input.dir ?? config2.name);
+    summary(config2, plan.value, dir);
+    if (interactive) {
+      const proceed = await confirm({ message: "Proceed with scaffolding?" });
+      if (isCancel(proceed) || !proceed) {
+        cancel3("Nothing was written.");
+        process.exit(0);
+      }
+    }
+    const installer = input.install ? installLog(config2) : undefined;
+    const result = await writeProject(plan.value, config2, {
+      targetDir: dir,
       install: input.install,
-      git: input.git
+      git: input.git,
+      onWarn: (message) => log3.warn(message),
+      onOutput: installer?.onOutput
     });
-    if (!res.ok) {
-      console.error(`✗ ${res.error.message}`);
-      process.exit(1);
-    }
-    console.error(`✓ created ${config2.name} → ${res.value.dir} (${res.value.fileCount} files)`);
-    console.error(`  next: cd ${res.value.dir} && ${config2.packageManager} install`);
+    installer?.finish(result.installError);
+    nextSteps(config2, plan.value, result.dir, result.installError === null);
   })
 });
 var cli = createCli({ router, name: "create-turbo-wizard", version: package_default.version });