Manual setup

npx create-next-app@latest avocado-demo --ts --app --tailwind --eslint \
  --no-src-dir --import-alias "@/*" --use-npm --yes
cd avocado-demo
npm install @avocadostudio-ai/site-sdk @avocadostudio-ai/orchestrator-core

# create-next-app writes a starter page at app/page.tsx. It matches "/" more
# specifically than the catch-all route below, so leaving it in place means
# your site is the Next.js starter and nothing anywhere says why.
rm app/page.tsx
mkdir -p content lib "app/api/editor/[...path]" "app/api/avocado/[[...path]]" "app/[[...slug]]"

cat > next.config.ts <<'EOF'
import { withAvocado } from "@avocadostudio-ai/site-sdk/next-config"
export default withAvocado({})
EOF

cat > content/pages.json <<'EOF'
[
  {
    "id": "home",
    "slug": "/",
    "title": "Home",
    "updatedAt": "2026-01-01T00:00:00.000Z",
    "blocks": [
      { "id": "hero-1", "type": "Hero", "props": {
          "heading": "Welcome to my site",
          "subheading": "A Next.js page you can edit by talking to it.",
          "ctaText": "Get started", "ctaHref": "#cta-1" } },
      { "id": "cta-1", "type": "CTA", "props": {
          "title": "Ready when you are",
          "description": "Ask the chat editor to change any of this.",
          "ctaText": "Book a demo", "ctaHref": "/contact" } }
    ]
  }
]
EOF

cat > lib/content.ts <<'EOF'
import type { PageDoc, SiteConfig } from "@avocadostudio-ai/shared"
import pages from "../content/pages.json"

const all = pages as PageDoc[]

export async function getPage(slug: string): Promise<PageDoc | null> {
  return all.find((page) => page.slug === slug) ?? null
}
export async function getSlugs(): Promise<string[]> {
  return all.map((page) => page.slug)
}
export async function getPages(): Promise<PageDoc[]> {
  return all
}
export async function getSiteConfig(): Promise<SiteConfig> {
  return { name: "My Site" }
}
EOF

cat > "app/api/editor/[...path]/route.ts" <<'EOF'
import { resolve } from "node:path"
import { createEditorApiHandler } from "@avocadostudio-ai/site-sdk/routes"
import { createJsonFilePublishHandler } from "@avocadostudio-ai/site-sdk/publish-handlers/json-file"
import { getPages } from "../../../../lib/content"

export const { GET, POST, OPTIONS } = createEditorApiHandler({
  getPages,
  onPublish: createJsonFilePublishHandler(resolve(process.cwd(), "content/pages.json")),
  // This route replaces the site's content. Unset, it refuses everything under
  // NODE_ENV=production rather than running unguarded.
  publishSecret: process.env.PUBLISH_TOKEN?.trim() || undefined,
})
EOF

cat > "app/api/avocado/[[...path]]/route.ts" <<'EOF'
import path from "node:path"
import { createOrchestrator } from "@avocadostudio-ai/site-sdk/server"
import { jsonFileAdapter } from "@avocadostudio-ai/orchestrator-core/cms"

export const runtime = "nodejs"
export const dynamic = "force-dynamic"

const handler = createOrchestrator({
  // writeOnPublish defaults to false, which leaves the adapter with no
  // onPublish — and Publish then reports success and rewrites nothing.
  adapter: jsonFileAdapter({
    path: path.join(process.cwd(), "content", "pages.json"),
    writeOnPublish: true,
  }),
  siteId: "my-site",
  siteName: "My Site",
})

export const POST = handler
export const GET = handler
export const OPTIONS = handler
EOF

cat > "app/[[...slug]]/page.tsx" <<'EOF'
import { createSitePage } from "@avocadostudio-ai/site-sdk/page"
import { getPage, getSlugs, getSiteConfig } from "../../lib/content"

const { Page, generateStaticParams, generateMetadata } = createSitePage({
  siteId: "my-site",
  siteName: "My Site",
  getPage,
  getSlugs,
  getSiteConfig,
  // Where this site lives. Nothing in a page's own content can supply it, and
  // three tags need it: the canonical link, og:url, and an absolute og:image.
  siteUrl: process.env.NEXT_PUBLIC_SITE_URL,
})

export default Page
export { generateStaticParams, generateMetadata }
EOF

# The blocks ship their own stylesheet. Without this the page renders, and
# renders unstyled.
printf '@import "@avocadostudio-ai/blocks/styles.css";\n%s' "$(cat app/globals.css)" > app/globals.css

# The orchestrator writes its SQLite state into .data/ on the first request, and
# create-next-app's .gitignore does not cover it. Without this line the first
# `git add .` after the first run commits a database.
echo '.data/' >> .gitignore

{
  echo 'ANTHROPIC_API_KEY=sk-ant-REPLACE_ME'
  echo 'ORCHESTRATOR_URL=http://localhost:3000/api/avocado'
  echo 'NEXT_PUBLIC_SITE_URL=http://localhost:3000'
  echo "DRAFT_MODE_SECRET=$(openssl rand -hex 32)"
  echo "PUBLISH_TOKEN=$(openssl rand -hex 32)"
} > .env.local

pnpm add @avocadostudio-ai/site-sdk @avocadostudio-ai/orchestrator-core

// next.config.ts
import { withAvocado } from "@avocadostudio-ai/site-sdk/next-config"

export default withAvocado({ /* your existing config */ })

@import "@avocadostudio-ai/blocks/styles.css";

// lib/content.ts
import type { PageDoc, SiteConfig } from "@avocadostudio-ai/shared"
import pages from "../content/pages.json"

const all = pages as PageDoc[]

export async function getPage(slug: string): Promise<PageDoc | null> {
  return all.find((page) => page.slug === slug) ?? null
}

export async function getSlugs(): Promise<string[]> {
  return all.map((page) => page.slug)
}

export async function getPages(): Promise<PageDoc[]> {
  return all
}

export async function getSiteConfig(): Promise<SiteConfig> {
  return { name: "My Site" }
}

// app/api/editor/[...path]/route.ts
import { createEditorApiHandler } from "@avocadostudio-ai/site-sdk/routes"
import { getPages } from "../../../../lib/content"

export const { GET, POST, OPTIONS } = createEditorApiHandler({
  getPages,
})

// app/api/avocado/[[...path]]/route.ts
import path from "node:path"
import { createOrchestrator } from "@avocadostudio-ai/site-sdk/server"
import { jsonFileAdapter } from "@avocadostudio-ai/orchestrator-core/cms"

export const runtime = "nodejs"
export const dynamic = "force-dynamic"

const handler = createOrchestrator({
  adapter: jsonFileAdapter({
    path: path.join(process.cwd(), "content", "pages.json"),
    writeOnPublish: true,
  }),
  siteId: "my-site",
  siteName: "My Site",
})

export const POST = handler
export const GET = handler
export const OPTIONS = handler

// app/[[...slug]]/page.tsx
import { createSitePage } from "@avocadostudio-ai/site-sdk/page"
import { getPage, getSlugs, getSiteConfig } from "../../lib/content"

const { Page, generateStaticParams, generateMetadata } = createSitePage({
  siteId: "my-site",
  siteName: "My Site",
  getPage,
  getSlugs,
  getSiteConfig,
  siteUrl: process.env.NEXT_PUBLIC_SITE_URL,
})

export default Page
export { generateStaticParams, generateMetadata }

# .env.local
ANTHROPIC_API_KEY=sk-ant-...
ORCHESTRATOR_URL=http://localhost:3000/api/avocado
NEXT_PUBLIC_SITE_URL=http://localhost:3000