[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-vercel-next-forge":3,"mdc--tp79mw-key":34,"related-repo-vercel-next-forge":1413,"related-org-vercel-next-forge":1523},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":23,"repoUrl":24,"updatedAt":25,"license":26,"forks":27,"topics":28,"repo":29,"sourceUrl":32,"mdContent":33},"next-forge","build SaaS applications with next-forge","next-forge expert guidance — production-grade Turborepo monorepo SaaS starter by Vercel. Use when working in a next-forge project, scaffolding with `npx next-forge init`, or editing @repo\u002F* workspace packages.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},"vercel","Vercel","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fvercel.png",[12,14,17,20],{"name":9,"slug":8,"type":13},"tag",{"name":15,"slug":16,"type":13},"SaaS","saas",{"name":18,"slug":19,"type":13},"Next.js","next-js",{"name":21,"slug":22,"type":13},"Turborepo","turborepo",226,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fvercel-plugin","2026-04-06T18:56:31.773727",null,36,[],{"repoUrl":24,"stars":23,"forks":27,"topics":30,"description":31},[],"Comprehensive Vercel ecosystem plugin — relational knowledge graph, skills for every major product, specialized agents, and Vercel conventions. Turns any AI agent into a Vercel expert.","https:\u002F\u002Fgithub.com\u002Fvercel\u002Fvercel-plugin\u002Ftree\u002FHEAD\u002Fskills\u002Fnext-forge","---\nname: next-forge\ndescription: next-forge expert guidance — production-grade Turborepo monorepo SaaS starter by Vercel. Use when working in a next-forge project, scaffolding with `npx next-forge init`, or editing @repo\u002F* workspace packages.\nsummary: \"next-forge monorepo SaaS starter (Turborepo, Clerk, Prisma\u002FNeon, Stripe, Resend, shadcn\u002Fui, Sentry, PostHog). See => skill:next-forge for full guide.\"\nmetadata:\n  priority: 6\n  docs:\n    - \"https:\u002F\u002Fnext-forge.com\u002Fdocs\"\n    - \"https:\u002F\u002Fgithub.com\u002Fhaydenbleasel\u002Fnext-forge\"\n  pathPatterns:\n    - 'pnpm-workspace.yaml'\n    - 'apps\u002Fapp\u002F**'\n    - 'apps\u002Fweb\u002F**'\n    - 'apps\u002Fapi\u002F**'\n    - 'apps\u002Femail\u002F**'\n    - 'apps\u002Fdocs\u002F**'\n    - 'apps\u002Fstudio\u002F**'\n    - 'apps\u002Fstorybook\u002F**'\n    - 'packages\u002Fauth\u002F**'\n    - 'packages\u002Fdatabase\u002F**'\n    - 'packages\u002Fdesign-system\u002F**'\n    - 'packages\u002Fpayments\u002F**'\n    - 'packages\u002Femail\u002F**'\n    - 'packages\u002Fanalytics\u002F**'\n    - 'packages\u002Fobservability\u002F**'\n    - 'packages\u002Fsecurity\u002F**'\n    - 'packages\u002Fai\u002F**'\n    - 'packages\u002Fcms\u002F**'\n    - 'packages\u002Fcollaboration\u002F**'\n    - 'packages\u002Ffeature-flags\u002F**'\n    - 'packages\u002Finternationalization\u002F**'\n    - 'packages\u002Fnotifications\u002F**'\n    - 'packages\u002Frate-limit\u002F**'\n    - 'packages\u002Fseo\u002F**'\n    - 'packages\u002Fstorage\u002F**'\n    - 'packages\u002Fwebhooks\u002F**'\n    - 'packages\u002Fnext-config\u002F**'\n    - 'packages\u002Ftypescript-config\u002F**'\n    - '**\u002Fkeys.ts'\n    - '**\u002Fenv.ts'\n    - '**\u002Fproxy.ts'\n    - 'biome.jsonc'\n  bashPatterns:\n    - '\\bnext-forge\\b'\n    - '\\bnpx\\s+next-forge\\b'\n    - '\\bpnpm\\s+migrate\\b'\n    - '\\bpnpm\\s+bump-deps\\b'\n    - '\\bpnpm\\s+bump-ui\\b'\n    - '\\bprisma\\s+(generate|db\\s+push|format|studio)\\b'\n    - '\\bstripe\\s+listen\\b'\n    - '\\bnpx\\s+shadcn@latest\\s+add\\b.*-c\\s+packages\u002Fdesign-system\\b'\n  importPatterns:\n    - '@repo\u002Fauth'\n    - '@repo\u002Fdatabase'\n    - '@repo\u002Fdesign-system'\n    - '@repo\u002Fpayments'\n    - '@repo\u002Femail'\n    - '@repo\u002Fanalytics'\n    - '@repo\u002Fobservability'\n    - '@repo\u002Fsecurity'\n    - '@repo\u002Fai'\n    - '@repo\u002Fcms'\n    - '@repo\u002Fcollaboration'\n    - '@repo\u002Ffeature-flags'\n    - '@repo\u002Finternationalization'\n    - '@repo\u002Fnotifications'\n    - '@repo\u002Frate-limit'\n    - '@repo\u002Fseo'\n    - '@repo\u002Fstorage'\n    - '@repo\u002Fwebhooks'\n    - '@repo\u002Fnext-config'\n    - '@t3-oss\u002Fenv-nextjs'\n    - '@rescale\u002Fnemo'\n  promptSignals:\n    phrases:\n      - 'next-forge'\n      - 'next forge'\n      - '@repo\u002F'\n    allOf:\n      -\n        - 'monorepo'\n        - 'saas'\n        - 'starter'\n      -\n        - 'turborepo'\n        - 'clerk'\n        - 'stripe'\n    anyOf:\n      - 'saas starter'\n      - 'production monorepo'\n      - 'keys.ts'\n      - 'pnpm-workspace'\n    noneOf:\n      - 'create-t3-app'\n    minScore: 6\nvalidate:\n  -\n    pattern: '\"pipeline\"\\s*:'\n    message: 'turbo.json \"pipeline\" was renamed to \"tasks\" in Turborepo v2 — update to \"tasks\"'\n    severity: error\n  -\n    pattern: 'new Pool\\('\n    message: 'PrismaNeon expects a connection config object, not a Pool instance — use PrismaNeon({ connectionString: url })'\n    severity: error\n    skipIfFileContains: 'pg\\.Pool'\n  -\n    pattern: 'prisma studio --schema'\n    message: 'Prisma v7 removed --schema flag for studio — use --config instead'\n    severity: error\n  -\n    pattern: 'middleware\\.ts'\n    message: 'next-forge uses proxy.ts (Next.js 16+), not middleware.ts — rename to proxy.ts'\n    severity: warn\n    skipIfFileContains: 'proxy\\.ts'\nretrieval:\n  aliases:\n    - saas starter\n    - monorepo starter\n    - next forge\n    - turborepo template\n  intents:\n    - scaffold saas\n    - set up next-forge\n    - create monorepo project\n    - use next-forge\n  entities:\n    - next-forge\n    - '@repo\u002F*'\n    - Turborepo\n    - monorepo\n    - SaaS starter\nchainTo:\n  -\n    pattern: 'export\\s+(default\\s+)?function\\s+middleware'\n    targetSkill: routing-middleware\n    message: 'middleware.ts detected in next-forge project — loading Routing Middleware guidance for proxy.ts migration.'\n  -\n    pattern: '@clerk\u002F|clerkMiddleware|ClerkProvider|getAuth\\(\\)|auth\\(\\)'\n    targetSkill: auth\n    message: 'Clerk auth patterns in next-forge — loading Auth guidance for middleware auth, sign-in\u002Fsign-up flows, and organization handling.'\n    skipIfFileContains: '@auth0\u002F|@descope\u002F'\n---\n\n# next-forge\n\nnext-forge is a production-grade Turborepo template for building Next.js SaaS applications. It provides a monorepo structure with multiple apps, shared packages, and integrations for authentication, database, payments, email, CMS, analytics, observability, security, and more.\n\n## Quick Start\n\nInitialize a new project:\n\n```bash\nnpx next-forge@latest init\n```\n\nThe CLI prompts for a project name and package manager (bun, npm, yarn, or pnpm). After installation:\n\n1. Set the `DATABASE_URL` in `packages\u002Fdatabase\u002F.env` pointing to a PostgreSQL database (Neon recommended).\n2. Run database migrations: `bun run migrate`\n3. Add any optional integration keys to the appropriate `.env.local` files.\n4. Start development: `bun run dev`\n\nAll integrations besides the database are optional. Missing environment variables gracefully disable features rather than causing errors.\n\n## Architecture Overview\n\nThe monorepo contains apps and packages. Apps are deployable applications. Packages are shared libraries imported as `@repo\u002F\u003Cpackage-name>`.\n\n**Apps** (in `\u002Fapps\u002F`):\n\n| App | Port | Purpose |\n|-----|------|---------|\n| `app` | 3000 | Main authenticated SaaS application |\n| `web` | 3001 | Marketing website with CMS and SEO |\n| `api` | 3002 | Serverless API for webhooks, cron jobs |\n| `email` | 3003 | React Email preview server |\n| `docs` | 3004 | Documentation site (Mintlify) |\n| `storybook` | 6006 | Design system component workshop |\n| `studio` | 3005 | Prisma Studio for database editing |\n\n**Core Packages**: `auth`, `database`, `payments`, `email`, `cms`, `design-system`, `analytics`, `observability`, `security`, `storage`, `seo`, `feature-flags`, `internationalization`, `webhooks`, `cron`, `notifications`, `collaboration`, `ai`, `rate-limit`, `next-config`, `typescript-config`.\n\nFor detailed structure, see `references\u002Farchitecture.md`.\n\n## Key Concepts\n\n### Environment Variables\n\nEnvironment variable files live alongside apps and packages:\n\n- `apps\u002Fapp\u002F.env.local` — Main app keys (Clerk, Stripe, etc.)\n- `apps\u002Fweb\u002F.env.local` — Marketing site keys\n- `apps\u002Fapi\u002F.env.local` — API keys\n- `packages\u002Fdatabase\u002F.env` — `DATABASE_URL` (required)\n- `packages\u002Fcms\u002F.env.local` — BaseHub token\n- `packages\u002Finternationalization\u002F.env.local` — Languine project ID\n\nEach package has a `keys.ts` file that validates environment variables with Zod via `@t3-oss\u002Fenv-nextjs`. Type safety is enforced at build time.\n\n### Inter-App URLs\n\nLocal URLs are pre-configured:\n\n- `NEXT_PUBLIC_APP_URL=http:\u002F\u002Flocalhost:3000`\n- `NEXT_PUBLIC_WEB_URL=http:\u002F\u002Flocalhost:3001`\n- `NEXT_PUBLIC_API_URL=http:\u002F\u002Flocalhost:3002`\n- `NEXT_PUBLIC_DOCS_URL=http:\u002F\u002Flocalhost:3004`\n\nUpdate these to production domains when deploying (e.g., `app.yourdomain.com`, `www.yourdomain.com`).\n\n### Server Components First\n\n`page.tsx` and `layout.tsx` files are always server components. Client interactivity goes in separate files with `'use client'`. Access databases, secrets, and server-only APIs directly in server components and server actions.\n\n### Graceful Degradation\n\nAll integrations beyond the database are optional. Clients use optional chaining (e.g., `stripe?.prices.list()`, `resend?.emails.send()`). If the corresponding environment variable is not set, the feature is silently disabled.\n\n## Common Tasks\n\n### Running Development\n\n```bash\nbun run dev                  # All apps\nbun dev --filter app         # Single app (port 3000)\nbun dev --filter web         # Marketing site (port 3001)\n```\n\n### Database Migrations\n\nAfter changing `packages\u002Fdatabase\u002Fprisma\u002Fschema.prisma`:\n\n```bash\nbun run migrate\n```\n\nThis runs Prisma format, generate, and db push in sequence.\n\n### Adding shadcn\u002Fui Components\n\n```bash\nnpx shadcn@latest add [component] -c packages\u002Fdesign-system\n```\n\nUpdate existing components:\n\n```bash\nbun run bump-ui\n```\n\n### Adding a New Package\n\nCreate a new directory in `\u002Fpackages\u002F` with a `package.json` using the `@repo\u002F\u003Cname>` naming convention. Add it as a dependency in consuming apps.\n\n### Linting and Formatting\n\n```bash\nbun run lint                 # Check code style (Ultracite\u002FBiome)\nbun run format               # Fix code style\n```\n\n### Testing\n\n```bash\nbun run test                 # Run tests across monorepo\n```\n\n### Building\n\n```bash\nbun run build                # Build all apps and packages\nbun run analyze              # Bundle analysis\n```\n\n### Deployment\n\nDeploy to Vercel by creating separate projects for `app`, `web`, and `api` — each pointing to its respective root directory under `\u002Fapps\u002F`. Add environment variables per project or use Vercel Team Environment Variables.\n\nFor detailed setup and customization instructions, see:\n\n- `references\u002Fsetup.md` — Installation, prerequisites, environment variables, database and Stripe CLI setup\n- `references\u002Fpackages.md` — Detailed documentation for every package\n- `references\u002Fcustomization.md` — Swapping providers, extending features, deployment configuration\n- `references\u002Farchitecture.md` — Full monorepo structure, Turborepo pipeline, scripts\n",{"data":35,"body":163},{"name":4,"description":6,"summary":36,"metadata":37,"validate":124,"retrieval":141,"chainTo":153},"next-forge monorepo SaaS starter (Turborepo, Clerk, Prisma\u002FNeon, Stripe, Resend, shadcn\u002Fui, Sentry, PostHog). See => skill:next-forge for full guide.",{"priority":38,"docs":39,"pathPatterns":42,"bashPatterns":75,"importPatterns":84,"promptSignals":106},6,[40,41],"https:\u002F\u002Fnext-forge.com\u002Fdocs","https:\u002F\u002Fgithub.com\u002Fhaydenbleasel\u002Fnext-forge",[43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70,71,72,73,74],"pnpm-workspace.yaml","apps\u002Fapp\u002F**","apps\u002Fweb\u002F**","apps\u002Fapi\u002F**","apps\u002Femail\u002F**","apps\u002Fdocs\u002F**","apps\u002Fstudio\u002F**","apps\u002Fstorybook\u002F**","packages\u002Fauth\u002F**","packages\u002Fdatabase\u002F**","packages\u002Fdesign-system\u002F**","packages\u002Fpayments\u002F**","packages\u002Femail\u002F**","packages\u002Fanalytics\u002F**","packages\u002Fobservability\u002F**","packages\u002Fsecurity\u002F**","packages\u002Fai\u002F**","packages\u002Fcms\u002F**","packages\u002Fcollaboration\u002F**","packages\u002Ffeature-flags\u002F**","packages\u002Finternationalization\u002F**","packages\u002Fnotifications\u002F**","packages\u002Frate-limit\u002F**","packages\u002Fseo\u002F**","packages\u002Fstorage\u002F**","packages\u002Fwebhooks\u002F**","packages\u002Fnext-config\u002F**","packages\u002Ftypescript-config\u002F**","**\u002Fkeys.ts","**\u002Fenv.ts","**\u002Fproxy.ts","biome.jsonc",[76,77,78,79,80,81,82,83],"\\bnext-forge\\b","\\bnpx\\s+next-forge\\b","\\bpnpm\\s+migrate\\b","\\bpnpm\\s+bump-deps\\b","\\bpnpm\\s+bump-ui\\b","\\bprisma\\s+(generate|db\\s+push|format|studio)\\b","\\bstripe\\s+listen\\b","\\bnpx\\s+shadcn@latest\\s+add\\b.*-c\\s+packages\u002Fdesign-system\\b",[85,86,87,88,89,90,91,92,93,94,95,96,97,98,99,100,101,102,103,104,105],"@repo\u002Fauth","@repo\u002Fdatabase","@repo\u002Fdesign-system","@repo\u002Fpayments","@repo\u002Femail","@repo\u002Fanalytics","@repo\u002Fobservability","@repo\u002Fsecurity","@repo\u002Fai","@repo\u002Fcms","@repo\u002Fcollaboration","@repo\u002Ffeature-flags","@repo\u002Finternationalization","@repo\u002Fnotifications","@repo\u002Frate-limit","@repo\u002Fseo","@repo\u002Fstorage","@repo\u002Fwebhooks","@repo\u002Fnext-config","@t3-oss\u002Fenv-nextjs","@rescale\u002Fnemo",{"phrases":107,"allOf":110,"anyOf":117,"noneOf":122,"minScore":38},[4,108,109],"next forge","@repo\u002F",[111,114],[112,16,113],"monorepo","starter",[22,115,116],"clerk","stripe",[118,119,120,121],"saas starter","production monorepo","keys.ts","pnpm-workspace",[123],"create-t3-app",[125,129,133,136],{"pattern":126,"message":127,"severity":128},"\"pipeline\"\\s*:","turbo.json \"pipeline\" was renamed to \"tasks\" in Turborepo v2 — update to \"tasks\"","error",{"pattern":130,"message":131,"severity":128,"skipIfFileContains":132},"new Pool\\(","PrismaNeon expects a connection config object, not a Pool instance — use PrismaNeon({ connectionString: url })","pg\\.Pool",{"pattern":134,"message":135,"severity":128},"prisma studio --schema","Prisma v7 removed --schema flag for studio — use --config instead",{"pattern":137,"message":138,"severity":139,"skipIfFileContains":140},"middleware\\.ts","next-forge uses proxy.ts (Next.js 16+), not middleware.ts — rename to proxy.ts","warn","proxy\\.ts",{"aliases":142,"intents":145,"entities":150},[118,143,108,144],"monorepo starter","turborepo template",[146,147,148,149],"scaffold saas","set up next-forge","create monorepo project","use next-forge",[4,151,21,112,152],"@repo\u002F*","SaaS starter",[154,158],{"pattern":155,"targetSkill":156,"message":157},"export\\s+(default\\s+)?function\\s+middleware","routing-middleware","middleware.ts detected in next-forge project — loading Routing Middleware guidance for proxy.ts migration.",{"pattern":159,"targetSkill":160,"message":161,"skipIfFileContains":162},"@clerk\u002F|clerkMiddleware|ClerkProvider|getAuth\\(\\)|auth\\(\\)","auth","Clerk auth patterns in next-forge — loading Auth guidance for middleware auth, sign-in\u002Fsign-up flows, and organization handling.","@auth0\u002F|@descope\u002F",{"type":164,"children":165},"root",[166,173,179,186,191,226,231,292,297,303,316,335,522,678,690,696,703,708,784,803,809,814,853,873,879,906,912,932,938,944,1028,1034,1047,1070,1075,1081,1111,1116,1139,1145,1174,1180,1229,1235,1263,1269,1318,1324,1356,1361,1407],{"type":167,"tag":168,"props":169,"children":170},"element","h1",{"id":4},[171],{"type":172,"value":4},"text",{"type":167,"tag":174,"props":175,"children":176},"p",{},[177],{"type":172,"value":178},"next-forge is a production-grade Turborepo template for building Next.js SaaS applications. It provides a monorepo structure with multiple apps, shared packages, and integrations for authentication, database, payments, email, CMS, analytics, observability, security, and more.",{"type":167,"tag":180,"props":181,"children":183},"h2",{"id":182},"quick-start",[184],{"type":172,"value":185},"Quick Start",{"type":167,"tag":174,"props":187,"children":188},{},[189],{"type":172,"value":190},"Initialize a new project:",{"type":167,"tag":192,"props":193,"children":198},"pre",{"className":194,"code":195,"language":196,"meta":197,"style":197},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","npx next-forge@latest init\n","bash","",[199],{"type":167,"tag":200,"props":201,"children":202},"code",{"__ignoreMap":197},[203],{"type":167,"tag":204,"props":205,"children":208},"span",{"class":206,"line":207},"line",1,[209,215,221],{"type":167,"tag":204,"props":210,"children":212},{"style":211},"--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B",[213],{"type":172,"value":214},"npx",{"type":167,"tag":204,"props":216,"children":218},{"style":217},"--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D",[219],{"type":172,"value":220}," next-forge@latest",{"type":167,"tag":204,"props":222,"children":223},{"style":217},[224],{"type":172,"value":225}," init\n",{"type":167,"tag":174,"props":227,"children":228},{},[229],{"type":172,"value":230},"The CLI prompts for a project name and package manager (bun, npm, yarn, or pnpm). After installation:",{"type":167,"tag":232,"props":233,"children":234},"ol",{},[235,257,268,281],{"type":167,"tag":236,"props":237,"children":238},"li",{},[239,241,247,249,255],{"type":172,"value":240},"Set the ",{"type":167,"tag":200,"props":242,"children":244},{"className":243},[],[245],{"type":172,"value":246},"DATABASE_URL",{"type":172,"value":248}," in ",{"type":167,"tag":200,"props":250,"children":252},{"className":251},[],[253],{"type":172,"value":254},"packages\u002Fdatabase\u002F.env",{"type":172,"value":256}," pointing to a PostgreSQL database (Neon recommended).",{"type":167,"tag":236,"props":258,"children":259},{},[260,262],{"type":172,"value":261},"Run database migrations: ",{"type":167,"tag":200,"props":263,"children":265},{"className":264},[],[266],{"type":172,"value":267},"bun run migrate",{"type":167,"tag":236,"props":269,"children":270},{},[271,273,279],{"type":172,"value":272},"Add any optional integration keys to the appropriate ",{"type":167,"tag":200,"props":274,"children":276},{"className":275},[],[277],{"type":172,"value":278},".env.local",{"type":172,"value":280}," files.",{"type":167,"tag":236,"props":282,"children":283},{},[284,286],{"type":172,"value":285},"Start development: ",{"type":167,"tag":200,"props":287,"children":289},{"className":288},[],[290],{"type":172,"value":291},"bun run dev",{"type":167,"tag":174,"props":293,"children":294},{},[295],{"type":172,"value":296},"All integrations besides the database are optional. Missing environment variables gracefully disable features rather than causing errors.",{"type":167,"tag":180,"props":298,"children":300},{"id":299},"architecture-overview",[301],{"type":172,"value":302},"Architecture Overview",{"type":167,"tag":174,"props":304,"children":305},{},[306,308,314],{"type":172,"value":307},"The monorepo contains apps and packages. Apps are deployable applications. Packages are shared libraries imported as ",{"type":167,"tag":200,"props":309,"children":311},{"className":310},[],[312],{"type":172,"value":313},"@repo\u002F\u003Cpackage-name>",{"type":172,"value":315},".",{"type":167,"tag":174,"props":317,"children":318},{},[319,325,327,333],{"type":167,"tag":320,"props":321,"children":322},"strong",{},[323],{"type":172,"value":324},"Apps",{"type":172,"value":326}," (in ",{"type":167,"tag":200,"props":328,"children":330},{"className":329},[],[331],{"type":172,"value":332},"\u002Fapps\u002F",{"type":172,"value":334},"):",{"type":167,"tag":336,"props":337,"children":338},"table",{},[339,363],{"type":167,"tag":340,"props":341,"children":342},"thead",{},[343],{"type":167,"tag":344,"props":345,"children":346},"tr",{},[347,353,358],{"type":167,"tag":348,"props":349,"children":350},"th",{},[351],{"type":172,"value":352},"App",{"type":167,"tag":348,"props":354,"children":355},{},[356],{"type":172,"value":357},"Port",{"type":167,"tag":348,"props":359,"children":360},{},[361],{"type":172,"value":362},"Purpose",{"type":167,"tag":364,"props":365,"children":366},"tbody",{},[367,390,412,434,456,478,500],{"type":167,"tag":344,"props":368,"children":369},{},[370,380,385],{"type":167,"tag":371,"props":372,"children":373},"td",{},[374],{"type":167,"tag":200,"props":375,"children":377},{"className":376},[],[378],{"type":172,"value":379},"app",{"type":167,"tag":371,"props":381,"children":382},{},[383],{"type":172,"value":384},"3000",{"type":167,"tag":371,"props":386,"children":387},{},[388],{"type":172,"value":389},"Main authenticated SaaS application",{"type":167,"tag":344,"props":391,"children":392},{},[393,402,407],{"type":167,"tag":371,"props":394,"children":395},{},[396],{"type":167,"tag":200,"props":397,"children":399},{"className":398},[],[400],{"type":172,"value":401},"web",{"type":167,"tag":371,"props":403,"children":404},{},[405],{"type":172,"value":406},"3001",{"type":167,"tag":371,"props":408,"children":409},{},[410],{"type":172,"value":411},"Marketing website with CMS and SEO",{"type":167,"tag":344,"props":413,"children":414},{},[415,424,429],{"type":167,"tag":371,"props":416,"children":417},{},[418],{"type":167,"tag":200,"props":419,"children":421},{"className":420},[],[422],{"type":172,"value":423},"api",{"type":167,"tag":371,"props":425,"children":426},{},[427],{"type":172,"value":428},"3002",{"type":167,"tag":371,"props":430,"children":431},{},[432],{"type":172,"value":433},"Serverless API for webhooks, cron jobs",{"type":167,"tag":344,"props":435,"children":436},{},[437,446,451],{"type":167,"tag":371,"props":438,"children":439},{},[440],{"type":167,"tag":200,"props":441,"children":443},{"className":442},[],[444],{"type":172,"value":445},"email",{"type":167,"tag":371,"props":447,"children":448},{},[449],{"type":172,"value":450},"3003",{"type":167,"tag":371,"props":452,"children":453},{},[454],{"type":172,"value":455},"React Email preview server",{"type":167,"tag":344,"props":457,"children":458},{},[459,468,473],{"type":167,"tag":371,"props":460,"children":461},{},[462],{"type":167,"tag":200,"props":463,"children":465},{"className":464},[],[466],{"type":172,"value":467},"docs",{"type":167,"tag":371,"props":469,"children":470},{},[471],{"type":172,"value":472},"3004",{"type":167,"tag":371,"props":474,"children":475},{},[476],{"type":172,"value":477},"Documentation site (Mintlify)",{"type":167,"tag":344,"props":479,"children":480},{},[481,490,495],{"type":167,"tag":371,"props":482,"children":483},{},[484],{"type":167,"tag":200,"props":485,"children":487},{"className":486},[],[488],{"type":172,"value":489},"storybook",{"type":167,"tag":371,"props":491,"children":492},{},[493],{"type":172,"value":494},"6006",{"type":167,"tag":371,"props":496,"children":497},{},[498],{"type":172,"value":499},"Design system component workshop",{"type":167,"tag":344,"props":501,"children":502},{},[503,512,517],{"type":167,"tag":371,"props":504,"children":505},{},[506],{"type":167,"tag":200,"props":507,"children":509},{"className":508},[],[510],{"type":172,"value":511},"studio",{"type":167,"tag":371,"props":513,"children":514},{},[515],{"type":172,"value":516},"3005",{"type":167,"tag":371,"props":518,"children":519},{},[520],{"type":172,"value":521},"Prisma Studio for database editing",{"type":167,"tag":174,"props":523,"children":524},{},[525,530,532,537,539,545,546,552,553,558,559,565,566,572,573,579,580,586,587,593,594,600,601,607,608,614,615,621,622,628,629,635,636,642,643,649,650,656,657,663,664,670,671,677],{"type":167,"tag":320,"props":526,"children":527},{},[528],{"type":172,"value":529},"Core Packages",{"type":172,"value":531},": ",{"type":167,"tag":200,"props":533,"children":535},{"className":534},[],[536],{"type":172,"value":160},{"type":172,"value":538},", ",{"type":167,"tag":200,"props":540,"children":542},{"className":541},[],[543],{"type":172,"value":544},"database",{"type":172,"value":538},{"type":167,"tag":200,"props":547,"children":549},{"className":548},[],[550],{"type":172,"value":551},"payments",{"type":172,"value":538},{"type":167,"tag":200,"props":554,"children":556},{"className":555},[],[557],{"type":172,"value":445},{"type":172,"value":538},{"type":167,"tag":200,"props":560,"children":562},{"className":561},[],[563],{"type":172,"value":564},"cms",{"type":172,"value":538},{"type":167,"tag":200,"props":567,"children":569},{"className":568},[],[570],{"type":172,"value":571},"design-system",{"type":172,"value":538},{"type":167,"tag":200,"props":574,"children":576},{"className":575},[],[577],{"type":172,"value":578},"analytics",{"type":172,"value":538},{"type":167,"tag":200,"props":581,"children":583},{"className":582},[],[584],{"type":172,"value":585},"observability",{"type":172,"value":538},{"type":167,"tag":200,"props":588,"children":590},{"className":589},[],[591],{"type":172,"value":592},"security",{"type":172,"value":538},{"type":167,"tag":200,"props":595,"children":597},{"className":596},[],[598],{"type":172,"value":599},"storage",{"type":172,"value":538},{"type":167,"tag":200,"props":602,"children":604},{"className":603},[],[605],{"type":172,"value":606},"seo",{"type":172,"value":538},{"type":167,"tag":200,"props":609,"children":611},{"className":610},[],[612],{"type":172,"value":613},"feature-flags",{"type":172,"value":538},{"type":167,"tag":200,"props":616,"children":618},{"className":617},[],[619],{"type":172,"value":620},"internationalization",{"type":172,"value":538},{"type":167,"tag":200,"props":623,"children":625},{"className":624},[],[626],{"type":172,"value":627},"webhooks",{"type":172,"value":538},{"type":167,"tag":200,"props":630,"children":632},{"className":631},[],[633],{"type":172,"value":634},"cron",{"type":172,"value":538},{"type":167,"tag":200,"props":637,"children":639},{"className":638},[],[640],{"type":172,"value":641},"notifications",{"type":172,"value":538},{"type":167,"tag":200,"props":644,"children":646},{"className":645},[],[647],{"type":172,"value":648},"collaboration",{"type":172,"value":538},{"type":167,"tag":200,"props":651,"children":653},{"className":652},[],[654],{"type":172,"value":655},"ai",{"type":172,"value":538},{"type":167,"tag":200,"props":658,"children":660},{"className":659},[],[661],{"type":172,"value":662},"rate-limit",{"type":172,"value":538},{"type":167,"tag":200,"props":665,"children":667},{"className":666},[],[668],{"type":172,"value":669},"next-config",{"type":172,"value":538},{"type":167,"tag":200,"props":672,"children":674},{"className":673},[],[675],{"type":172,"value":676},"typescript-config",{"type":172,"value":315},{"type":167,"tag":174,"props":679,"children":680},{},[681,683,689],{"type":172,"value":682},"For detailed structure, see ",{"type":167,"tag":200,"props":684,"children":686},{"className":685},[],[687],{"type":172,"value":688},"references\u002Farchitecture.md",{"type":172,"value":315},{"type":167,"tag":180,"props":691,"children":693},{"id":692},"key-concepts",[694],{"type":172,"value":695},"Key Concepts",{"type":167,"tag":697,"props":698,"children":700},"h3",{"id":699},"environment-variables",[701],{"type":172,"value":702},"Environment Variables",{"type":167,"tag":174,"props":704,"children":705},{},[706],{"type":172,"value":707},"Environment variable files live alongside apps and packages:",{"type":167,"tag":709,"props":710,"children":711},"ul",{},[712,723,734,745,762,773],{"type":167,"tag":236,"props":713,"children":714},{},[715,721],{"type":167,"tag":200,"props":716,"children":718},{"className":717},[],[719],{"type":172,"value":720},"apps\u002Fapp\u002F.env.local",{"type":172,"value":722}," — Main app keys (Clerk, Stripe, etc.)",{"type":167,"tag":236,"props":724,"children":725},{},[726,732],{"type":167,"tag":200,"props":727,"children":729},{"className":728},[],[730],{"type":172,"value":731},"apps\u002Fweb\u002F.env.local",{"type":172,"value":733}," — Marketing site keys",{"type":167,"tag":236,"props":735,"children":736},{},[737,743],{"type":167,"tag":200,"props":738,"children":740},{"className":739},[],[741],{"type":172,"value":742},"apps\u002Fapi\u002F.env.local",{"type":172,"value":744}," — API keys",{"type":167,"tag":236,"props":746,"children":747},{},[748,753,755,760],{"type":167,"tag":200,"props":749,"children":751},{"className":750},[],[752],{"type":172,"value":254},{"type":172,"value":754}," — ",{"type":167,"tag":200,"props":756,"children":758},{"className":757},[],[759],{"type":172,"value":246},{"type":172,"value":761}," (required)",{"type":167,"tag":236,"props":763,"children":764},{},[765,771],{"type":167,"tag":200,"props":766,"children":768},{"className":767},[],[769],{"type":172,"value":770},"packages\u002Fcms\u002F.env.local",{"type":172,"value":772}," — BaseHub token",{"type":167,"tag":236,"props":774,"children":775},{},[776,782],{"type":167,"tag":200,"props":777,"children":779},{"className":778},[],[780],{"type":172,"value":781},"packages\u002Finternationalization\u002F.env.local",{"type":172,"value":783}," — Languine project ID",{"type":167,"tag":174,"props":785,"children":786},{},[787,789,794,796,801],{"type":172,"value":788},"Each package has a ",{"type":167,"tag":200,"props":790,"children":792},{"className":791},[],[793],{"type":172,"value":120},{"type":172,"value":795}," file that validates environment variables with Zod via ",{"type":167,"tag":200,"props":797,"children":799},{"className":798},[],[800],{"type":172,"value":104},{"type":172,"value":802},". Type safety is enforced at build time.",{"type":167,"tag":697,"props":804,"children":806},{"id":805},"inter-app-urls",[807],{"type":172,"value":808},"Inter-App URLs",{"type":167,"tag":174,"props":810,"children":811},{},[812],{"type":172,"value":813},"Local URLs are pre-configured:",{"type":167,"tag":709,"props":815,"children":816},{},[817,826,835,844],{"type":167,"tag":236,"props":818,"children":819},{},[820],{"type":167,"tag":200,"props":821,"children":823},{"className":822},[],[824],{"type":172,"value":825},"NEXT_PUBLIC_APP_URL=http:\u002F\u002Flocalhost:3000",{"type":167,"tag":236,"props":827,"children":828},{},[829],{"type":167,"tag":200,"props":830,"children":832},{"className":831},[],[833],{"type":172,"value":834},"NEXT_PUBLIC_WEB_URL=http:\u002F\u002Flocalhost:3001",{"type":167,"tag":236,"props":836,"children":837},{},[838],{"type":167,"tag":200,"props":839,"children":841},{"className":840},[],[842],{"type":172,"value":843},"NEXT_PUBLIC_API_URL=http:\u002F\u002Flocalhost:3002",{"type":167,"tag":236,"props":845,"children":846},{},[847],{"type":167,"tag":200,"props":848,"children":850},{"className":849},[],[851],{"type":172,"value":852},"NEXT_PUBLIC_DOCS_URL=http:\u002F\u002Flocalhost:3004",{"type":167,"tag":174,"props":854,"children":855},{},[856,858,864,865,871],{"type":172,"value":857},"Update these to production domains when deploying (e.g., ",{"type":167,"tag":200,"props":859,"children":861},{"className":860},[],[862],{"type":172,"value":863},"app.yourdomain.com",{"type":172,"value":538},{"type":167,"tag":200,"props":866,"children":868},{"className":867},[],[869],{"type":172,"value":870},"www.yourdomain.com",{"type":172,"value":872},").",{"type":167,"tag":697,"props":874,"children":876},{"id":875},"server-components-first",[877],{"type":172,"value":878},"Server Components First",{"type":167,"tag":174,"props":880,"children":881},{},[882,888,890,896,898,904],{"type":167,"tag":200,"props":883,"children":885},{"className":884},[],[886],{"type":172,"value":887},"page.tsx",{"type":172,"value":889}," and ",{"type":167,"tag":200,"props":891,"children":893},{"className":892},[],[894],{"type":172,"value":895},"layout.tsx",{"type":172,"value":897}," files are always server components. Client interactivity goes in separate files with ",{"type":167,"tag":200,"props":899,"children":901},{"className":900},[],[902],{"type":172,"value":903},"'use client'",{"type":172,"value":905},". Access databases, secrets, and server-only APIs directly in server components and server actions.",{"type":167,"tag":697,"props":907,"children":909},{"id":908},"graceful-degradation",[910],{"type":172,"value":911},"Graceful Degradation",{"type":167,"tag":174,"props":913,"children":914},{},[915,917,923,924,930],{"type":172,"value":916},"All integrations beyond the database are optional. Clients use optional chaining (e.g., ",{"type":167,"tag":200,"props":918,"children":920},{"className":919},[],[921],{"type":172,"value":922},"stripe?.prices.list()",{"type":172,"value":538},{"type":167,"tag":200,"props":925,"children":927},{"className":926},[],[928],{"type":172,"value":929},"resend?.emails.send()",{"type":172,"value":931},"). If the corresponding environment variable is not set, the feature is silently disabled.",{"type":167,"tag":180,"props":933,"children":935},{"id":934},"common-tasks",[936],{"type":172,"value":937},"Common Tasks",{"type":167,"tag":697,"props":939,"children":941},{"id":940},"running-development",[942],{"type":172,"value":943},"Running Development",{"type":167,"tag":192,"props":945,"children":947},{"className":194,"code":946,"language":196,"meta":197,"style":197},"bun run dev                  # All apps\nbun dev --filter app         # Single app (port 3000)\nbun dev --filter web         # Marketing site (port 3001)\n",[948],{"type":167,"tag":200,"props":949,"children":950},{"__ignoreMap":197},[951,975,1002],{"type":167,"tag":204,"props":952,"children":953},{"class":206,"line":207},[954,959,964,969],{"type":167,"tag":204,"props":955,"children":956},{"style":211},[957],{"type":172,"value":958},"bun",{"type":167,"tag":204,"props":960,"children":961},{"style":217},[962],{"type":172,"value":963}," run",{"type":167,"tag":204,"props":965,"children":966},{"style":217},[967],{"type":172,"value":968}," dev",{"type":167,"tag":204,"props":970,"children":972},{"style":971},"--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic",[973],{"type":172,"value":974},"                  # All apps\n",{"type":167,"tag":204,"props":976,"children":978},{"class":206,"line":977},2,[979,983,987,992,997],{"type":167,"tag":204,"props":980,"children":981},{"style":211},[982],{"type":172,"value":958},{"type":167,"tag":204,"props":984,"children":985},{"style":217},[986],{"type":172,"value":968},{"type":167,"tag":204,"props":988,"children":989},{"style":217},[990],{"type":172,"value":991}," --filter",{"type":167,"tag":204,"props":993,"children":994},{"style":217},[995],{"type":172,"value":996}," app",{"type":167,"tag":204,"props":998,"children":999},{"style":971},[1000],{"type":172,"value":1001},"         # Single app (port 3000)\n",{"type":167,"tag":204,"props":1003,"children":1005},{"class":206,"line":1004},3,[1006,1010,1014,1018,1023],{"type":167,"tag":204,"props":1007,"children":1008},{"style":211},[1009],{"type":172,"value":958},{"type":167,"tag":204,"props":1011,"children":1012},{"style":217},[1013],{"type":172,"value":968},{"type":167,"tag":204,"props":1015,"children":1016},{"style":217},[1017],{"type":172,"value":991},{"type":167,"tag":204,"props":1019,"children":1020},{"style":217},[1021],{"type":172,"value":1022}," web",{"type":167,"tag":204,"props":1024,"children":1025},{"style":971},[1026],{"type":172,"value":1027},"         # Marketing site (port 3001)\n",{"type":167,"tag":697,"props":1029,"children":1031},{"id":1030},"database-migrations",[1032],{"type":172,"value":1033},"Database Migrations",{"type":167,"tag":174,"props":1035,"children":1036},{},[1037,1039,1045],{"type":172,"value":1038},"After changing ",{"type":167,"tag":200,"props":1040,"children":1042},{"className":1041},[],[1043],{"type":172,"value":1044},"packages\u002Fdatabase\u002Fprisma\u002Fschema.prisma",{"type":172,"value":1046},":",{"type":167,"tag":192,"props":1048,"children":1050},{"className":194,"code":1049,"language":196,"meta":197,"style":197},"bun run migrate\n",[1051],{"type":167,"tag":200,"props":1052,"children":1053},{"__ignoreMap":197},[1054],{"type":167,"tag":204,"props":1055,"children":1056},{"class":206,"line":207},[1057,1061,1065],{"type":167,"tag":204,"props":1058,"children":1059},{"style":211},[1060],{"type":172,"value":958},{"type":167,"tag":204,"props":1062,"children":1063},{"style":217},[1064],{"type":172,"value":963},{"type":167,"tag":204,"props":1066,"children":1067},{"style":217},[1068],{"type":172,"value":1069}," migrate\n",{"type":167,"tag":174,"props":1071,"children":1072},{},[1073],{"type":172,"value":1074},"This runs Prisma format, generate, and db push in sequence.",{"type":167,"tag":697,"props":1076,"children":1078},{"id":1077},"adding-shadcnui-components",[1079],{"type":172,"value":1080},"Adding shadcn\u002Fui Components",{"type":167,"tag":192,"props":1082,"children":1084},{"className":194,"code":1083,"language":196,"meta":197,"style":197},"npx shadcn@latest add [component] -c packages\u002Fdesign-system\n",[1085],{"type":167,"tag":200,"props":1086,"children":1087},{"__ignoreMap":197},[1088],{"type":167,"tag":204,"props":1089,"children":1090},{"class":206,"line":207},[1091,1095,1100,1105],{"type":167,"tag":204,"props":1092,"children":1093},{"style":211},[1094],{"type":172,"value":214},{"type":167,"tag":204,"props":1096,"children":1097},{"style":217},[1098],{"type":172,"value":1099}," shadcn@latest",{"type":167,"tag":204,"props":1101,"children":1102},{"style":217},[1103],{"type":172,"value":1104}," add",{"type":167,"tag":204,"props":1106,"children":1108},{"style":1107},"--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8",[1109],{"type":172,"value":1110}," [component] -c packages\u002Fdesign-system\n",{"type":167,"tag":174,"props":1112,"children":1113},{},[1114],{"type":172,"value":1115},"Update existing components:",{"type":167,"tag":192,"props":1117,"children":1119},{"className":194,"code":1118,"language":196,"meta":197,"style":197},"bun run bump-ui\n",[1120],{"type":167,"tag":200,"props":1121,"children":1122},{"__ignoreMap":197},[1123],{"type":167,"tag":204,"props":1124,"children":1125},{"class":206,"line":207},[1126,1130,1134],{"type":167,"tag":204,"props":1127,"children":1128},{"style":211},[1129],{"type":172,"value":958},{"type":167,"tag":204,"props":1131,"children":1132},{"style":217},[1133],{"type":172,"value":963},{"type":167,"tag":204,"props":1135,"children":1136},{"style":217},[1137],{"type":172,"value":1138}," bump-ui\n",{"type":167,"tag":697,"props":1140,"children":1142},{"id":1141},"adding-a-new-package",[1143],{"type":172,"value":1144},"Adding a New Package",{"type":167,"tag":174,"props":1146,"children":1147},{},[1148,1150,1156,1158,1164,1166,1172],{"type":172,"value":1149},"Create a new directory in ",{"type":167,"tag":200,"props":1151,"children":1153},{"className":1152},[],[1154],{"type":172,"value":1155},"\u002Fpackages\u002F",{"type":172,"value":1157}," with a ",{"type":167,"tag":200,"props":1159,"children":1161},{"className":1160},[],[1162],{"type":172,"value":1163},"package.json",{"type":172,"value":1165}," using the ",{"type":167,"tag":200,"props":1167,"children":1169},{"className":1168},[],[1170],{"type":172,"value":1171},"@repo\u002F\u003Cname>",{"type":172,"value":1173}," naming convention. Add it as a dependency in consuming apps.",{"type":167,"tag":697,"props":1175,"children":1177},{"id":1176},"linting-and-formatting",[1178],{"type":172,"value":1179},"Linting and Formatting",{"type":167,"tag":192,"props":1181,"children":1183},{"className":194,"code":1182,"language":196,"meta":197,"style":197},"bun run lint                 # Check code style (Ultracite\u002FBiome)\nbun run format               # Fix code style\n",[1184],{"type":167,"tag":200,"props":1185,"children":1186},{"__ignoreMap":197},[1187,1208],{"type":167,"tag":204,"props":1188,"children":1189},{"class":206,"line":207},[1190,1194,1198,1203],{"type":167,"tag":204,"props":1191,"children":1192},{"style":211},[1193],{"type":172,"value":958},{"type":167,"tag":204,"props":1195,"children":1196},{"style":217},[1197],{"type":172,"value":963},{"type":167,"tag":204,"props":1199,"children":1200},{"style":217},[1201],{"type":172,"value":1202}," lint",{"type":167,"tag":204,"props":1204,"children":1205},{"style":971},[1206],{"type":172,"value":1207},"                 # Check code style (Ultracite\u002FBiome)\n",{"type":167,"tag":204,"props":1209,"children":1210},{"class":206,"line":977},[1211,1215,1219,1224],{"type":167,"tag":204,"props":1212,"children":1213},{"style":211},[1214],{"type":172,"value":958},{"type":167,"tag":204,"props":1216,"children":1217},{"style":217},[1218],{"type":172,"value":963},{"type":167,"tag":204,"props":1220,"children":1221},{"style":217},[1222],{"type":172,"value":1223}," format",{"type":167,"tag":204,"props":1225,"children":1226},{"style":971},[1227],{"type":172,"value":1228},"               # Fix code style\n",{"type":167,"tag":697,"props":1230,"children":1232},{"id":1231},"testing",[1233],{"type":172,"value":1234},"Testing",{"type":167,"tag":192,"props":1236,"children":1238},{"className":194,"code":1237,"language":196,"meta":197,"style":197},"bun run test                 # Run tests across monorepo\n",[1239],{"type":167,"tag":200,"props":1240,"children":1241},{"__ignoreMap":197},[1242],{"type":167,"tag":204,"props":1243,"children":1244},{"class":206,"line":207},[1245,1249,1253,1258],{"type":167,"tag":204,"props":1246,"children":1247},{"style":211},[1248],{"type":172,"value":958},{"type":167,"tag":204,"props":1250,"children":1251},{"style":217},[1252],{"type":172,"value":963},{"type":167,"tag":204,"props":1254,"children":1255},{"style":217},[1256],{"type":172,"value":1257}," test",{"type":167,"tag":204,"props":1259,"children":1260},{"style":971},[1261],{"type":172,"value":1262},"                 # Run tests across monorepo\n",{"type":167,"tag":697,"props":1264,"children":1266},{"id":1265},"building",[1267],{"type":172,"value":1268},"Building",{"type":167,"tag":192,"props":1270,"children":1272},{"className":194,"code":1271,"language":196,"meta":197,"style":197},"bun run build                # Build all apps and packages\nbun run analyze              # Bundle analysis\n",[1273],{"type":167,"tag":200,"props":1274,"children":1275},{"__ignoreMap":197},[1276,1297],{"type":167,"tag":204,"props":1277,"children":1278},{"class":206,"line":207},[1279,1283,1287,1292],{"type":167,"tag":204,"props":1280,"children":1281},{"style":211},[1282],{"type":172,"value":958},{"type":167,"tag":204,"props":1284,"children":1285},{"style":217},[1286],{"type":172,"value":963},{"type":167,"tag":204,"props":1288,"children":1289},{"style":217},[1290],{"type":172,"value":1291}," build",{"type":167,"tag":204,"props":1293,"children":1294},{"style":971},[1295],{"type":172,"value":1296},"                # Build all apps and packages\n",{"type":167,"tag":204,"props":1298,"children":1299},{"class":206,"line":977},[1300,1304,1308,1313],{"type":167,"tag":204,"props":1301,"children":1302},{"style":211},[1303],{"type":172,"value":958},{"type":167,"tag":204,"props":1305,"children":1306},{"style":217},[1307],{"type":172,"value":963},{"type":167,"tag":204,"props":1309,"children":1310},{"style":217},[1311],{"type":172,"value":1312}," analyze",{"type":167,"tag":204,"props":1314,"children":1315},{"style":971},[1316],{"type":172,"value":1317},"              # Bundle analysis\n",{"type":167,"tag":697,"props":1319,"children":1321},{"id":1320},"deployment",[1322],{"type":172,"value":1323},"Deployment",{"type":167,"tag":174,"props":1325,"children":1326},{},[1327,1329,1334,1335,1340,1342,1347,1349,1354],{"type":172,"value":1328},"Deploy to Vercel by creating separate projects for ",{"type":167,"tag":200,"props":1330,"children":1332},{"className":1331},[],[1333],{"type":172,"value":379},{"type":172,"value":538},{"type":167,"tag":200,"props":1336,"children":1338},{"className":1337},[],[1339],{"type":172,"value":401},{"type":172,"value":1341},", and ",{"type":167,"tag":200,"props":1343,"children":1345},{"className":1344},[],[1346],{"type":172,"value":423},{"type":172,"value":1348}," — each pointing to its respective root directory under ",{"type":167,"tag":200,"props":1350,"children":1352},{"className":1351},[],[1353],{"type":172,"value":332},{"type":172,"value":1355},". Add environment variables per project or use Vercel Team Environment Variables.",{"type":167,"tag":174,"props":1357,"children":1358},{},[1359],{"type":172,"value":1360},"For detailed setup and customization instructions, see:",{"type":167,"tag":709,"props":1362,"children":1363},{},[1364,1375,1386,1397],{"type":167,"tag":236,"props":1365,"children":1366},{},[1367,1373],{"type":167,"tag":200,"props":1368,"children":1370},{"className":1369},[],[1371],{"type":172,"value":1372},"references\u002Fsetup.md",{"type":172,"value":1374}," — Installation, prerequisites, environment variables, database and Stripe CLI setup",{"type":167,"tag":236,"props":1376,"children":1377},{},[1378,1384],{"type":167,"tag":200,"props":1379,"children":1381},{"className":1380},[],[1382],{"type":172,"value":1383},"references\u002Fpackages.md",{"type":172,"value":1385}," — Detailed documentation for every package",{"type":167,"tag":236,"props":1387,"children":1388},{},[1389,1395],{"type":167,"tag":200,"props":1390,"children":1392},{"className":1391},[],[1393],{"type":172,"value":1394},"references\u002Fcustomization.md",{"type":172,"value":1396}," — Swapping providers, extending features, deployment configuration",{"type":167,"tag":236,"props":1398,"children":1399},{},[1400,1405],{"type":167,"tag":200,"props":1401,"children":1403},{"className":1402},[],[1404],{"type":172,"value":688},{"type":172,"value":1406}," — Full monorepo structure, Turborepo pipeline, scripts",{"type":167,"tag":1408,"props":1409,"children":1410},"style",{},[1411],{"type":172,"value":1412},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"items":1414,"total":1522},[1415,1432,1448,1463,1479,1496,1511],{"slug":1416,"name":1416,"fn":1417,"description":1418,"org":1419,"tags":1420,"stars":23,"repoUrl":24,"updatedAt":1431},"ai-gateway","configure and manage Vercel AI Gateway","Vercel AI Gateway expert guidance. Use when configuring model routing, provider failover, cost tracking, or managing multiple AI providers through a unified API.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1421,1424,1427,1430],{"name":1422,"slug":1423,"type":13},"AI Infrastructure","ai-infrastructure",{"name":1425,"slug":1426,"type":13},"Cost Optimization","cost-optimization",{"name":1428,"slug":1429,"type":13},"LLM","llm",{"name":9,"slug":8,"type":13},"2026-04-06T18:56:06.57787",{"slug":160,"name":160,"fn":1433,"description":1434,"org":1435,"tags":1436,"stars":23,"repoUrl":24,"updatedAt":1447},"integrate authentication in Next.js apps","Authentication integration guidance — Clerk (native Vercel Marketplace), Descope, and Auth0 setup for Next.js applications. Covers middleware auth patterns, sign-in\u002Fsign-up flows, and Marketplace provisioning. Use when implementing user authentication.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1437,1440,1443,1444,1446],{"name":1438,"slug":1439,"type":13},"Auth0","auth0",{"name":1441,"slug":1442,"type":13},"Authentication","authentication",{"name":18,"slug":19,"type":13},{"name":1445,"slug":592,"type":13},"Security",{"name":9,"slug":8,"type":13},"2026-04-06T18:56:17.050565",{"slug":1449,"name":1449,"fn":1450,"description":1451,"org":1452,"tags":1453,"stars":23,"repoUrl":24,"updatedAt":1462},"bootstrap","bootstrap Vercel-linked repositories","Project bootstrapping orchestrator for repos that depend on Vercel-linked resources (databases, auth, and managed integrations). Use when setting up or repairing a repository so linking, environment provisioning, env pulls, and first-run db\u002Fdev commands happen in the correct safe order.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1454,1457,1458,1461],{"name":1455,"slug":1456,"type":13},"Configuration","configuration",{"name":1323,"slug":1320,"type":13},{"name":1459,"slug":1460,"type":13},"Local Development","local-development",{"name":9,"slug":8,"type":13},"2026-04-06T18:56:18.297868",{"slug":1464,"name":1464,"fn":1465,"description":1466,"org":1467,"tags":1468,"stars":23,"repoUrl":24,"updatedAt":1478},"cdn-caching","debug Vercel CDN caching behavior","Debug Vercel CDN caching — cache hit rate, stale content, revalidation behavior, ISR + PPR, per-request cache reasons (cacheReason) and PPR state (ppr_state), and costs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1469,1472,1474,1477],{"name":1470,"slug":1471,"type":13},"Caching","caching",{"name":1473,"slug":585,"type":13},"Observability",{"name":1475,"slug":1476,"type":13},"Performance","performance",{"name":9,"slug":8,"type":13},"2026-07-30T05:31:34.628944",{"slug":1480,"name":1480,"fn":1481,"description":1482,"org":1483,"tags":1484,"stars":23,"repoUrl":24,"updatedAt":1495},"chat-sdk","build multi-platform chatbots with Vercel","Vercel Chat SDK expert guidance. Use when building multi-platform chat bots — Slack, Telegram, Microsoft Teams, Discord, Google Chat, GitHub, Linear — with a single codebase. Covers the Chat class, adapters, threads, messages, cards, modals, streaming, state management, and webhook setup.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1485,1488,1491,1494],{"name":1486,"slug":1487,"type":13},"Agents","agents",{"name":1489,"slug":1490,"type":13},"Messaging","messaging",{"name":1492,"slug":1493,"type":13},"SDK","sdk",{"name":9,"slug":8,"type":13},"2026-04-06T18:56:26.921901",{"slug":1497,"name":1497,"fn":1498,"description":1499,"org":1500,"tags":1501,"stars":23,"repoUrl":24,"updatedAt":1510},"deployments-cicd","manage Vercel deployments and CI\u002FCD","Vercel deployment and CI\u002FCD expert guidance. Use when deploying, promoting, rolling back, inspecting deployments, building with --prebuilt, or configuring CI workflow files for Vercel.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1502,1505,1506,1509],{"name":1503,"slug":1504,"type":13},"CI\u002FCD","ci-cd",{"name":1323,"slug":1320,"type":13},{"name":1507,"slug":1508,"type":13},"Operations","operations",{"name":9,"slug":8,"type":13},"2026-04-06T18:56:22.054263",{"slug":1512,"name":1512,"fn":1513,"description":1514,"org":1515,"tags":1516,"stars":23,"repoUrl":24,"updatedAt":1521},"env-vars","manage Vercel environment variables","Vercel environment variable expert guidance. Use when working with .env files, vercel env commands, OIDC tokens, or managing environment-specific configuration.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1517,1518,1519,1520],{"name":1455,"slug":1456,"type":13},{"name":1507,"slug":1508,"type":13},{"name":1445,"slug":592,"type":13},{"name":9,"slug":8,"type":13},"2026-04-06T18:56:28.150777",29,{"items":1524,"total":1683},[1525,1543,1555,1572,1583,1594,1608,1622,1634,1653,1663,1673],{"slug":1526,"name":1526,"fn":1527,"description":1528,"org":1529,"tags":1530,"stars":1540,"repoUrl":1541,"updatedAt":1542},"next-cache-components-adoption","enable and migrate to Next.js Cache Components","Turn on Cache Components in a Next.js app and resolve the blocking routes it surfaces. Use when the user wants to enable, adopt, or migrate to Cache Components, flip the `cacheComponents` flag, work through a flood of blocking-prerender \u002F instant validation errors, run the `cache-components-instant-false` codemod, or decide between opting routes out with `export const instant = false` and fixing them in place.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1531,1532,1535,1538,1539],{"name":1470,"slug":1471,"type":13},{"name":1533,"slug":1534,"type":13},"Frontend","frontend",{"name":1536,"slug":1537,"type":13},"Migration","migration",{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},141208,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fnext.js","2026-07-24T05:38:30.118542",{"slug":1544,"name":1544,"fn":1545,"description":1546,"org":1547,"tags":1548,"stars":1540,"repoUrl":1541,"updatedAt":1554},"next-cache-components-optimizer","optimize Next.js cache components","Drive a Next.js route to instant navigation by setting up an agentic loop, under Cache Components \u002F PPR, on initial load (hard navigation) and client-side navigation (soft navigation). Encode the goal as a failing @next\u002Fplaywright instant() e2e and work it to green, one verified route at a time; the shipped test then guards against regression. Use when asked to make a route's navigation instant (its static shell commits immediately), fix a route whose static shell isn't prerendered\u002Fserved\u002Fprefetched, grow a route's static shell or fix its slow first paint, diagnose which Suspense boundary keeps a route out of its static shell, or write the instant() e2e guard for one. Requires Next.js 16.3+ with cacheComponents; directs an upgrade if older.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1549,1550,1551,1552,1553],{"name":1470,"slug":1471,"type":13},{"name":1533,"slug":1534,"type":13},{"name":18,"slug":19,"type":13},{"name":1475,"slug":1476,"type":13},{"name":9,"slug":8,"type":13},"2026-07-30T05:31:10.674078",{"slug":1556,"name":1556,"fn":1557,"description":1558,"org":1559,"tags":1560,"stars":1540,"repoUrl":1541,"updatedAt":1571},"next-dev-loop","verify Next.js runtime behavior","Verify Next.js runtime behavior after editing app code. Use this skill to confirm a change actually works in a running app — not just that it compiles or type-checks. Combines \u002F_next\u002Fmcp (Next.js's view) with agent-browser (the browser's view). Requires a running `next dev`.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1561,1564,1565,1566,1567,1568],{"name":1562,"slug":1563,"type":13},"Debugging","debugging",{"name":1533,"slug":1534,"type":13},{"name":1459,"slug":1460,"type":13},{"name":18,"slug":19,"type":13},{"name":9,"slug":8,"type":13},{"name":1569,"slug":1570,"type":13},"Web Development","web-development","2026-05-22T06:45:28.627735",{"slug":1573,"name":1573,"fn":1574,"description":1575,"org":1576,"tags":1577,"stars":1540,"repoUrl":1541,"updatedAt":1582},"next-partial-prefetching-adoption","adopt Partial Prefetching in Next.js apps","Turn on Partial Prefetching in a Next.js app and work through the insights it surfaces. Use when the user wants to enable or adopt Partial Prefetching, flip the `partialPrefetching` flag, opt routes in with `export const prefetch = 'partial'`, audit `\u003CLink prefetch={true}>` calls, or resolve the link-prefetch-partial and instant-shell-url-data insights.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1578,1579,1580,1581],{"name":1533,"slug":1534,"type":13},{"name":18,"slug":19,"type":13},{"name":1475,"slug":1476,"type":13},{"name":9,"slug":8,"type":13},"2026-07-30T05:31:11.591864",{"slug":22,"name":22,"fn":1584,"description":1585,"org":1586,"tags":1587,"stars":1591,"repoUrl":1592,"updatedAt":1593},"manage monorepos with Turborepo","Turborepo monorepo build system guidance. Triggers on: turbo.json, task pipelines,\ndependsOn, caching, remote cache, the \"turbo\" CLI, --filter, --affected, CI optimization, environment\nvariables, internal packages, monorepo structure\u002Fbest practices, and boundaries.\n\nUse when user: configures tasks\u002Fworkflows\u002Fpipelines, creates packages, sets up\nmonorepo, shares code between apps, runs changed\u002Faffected packages, debugs cache,\nor has apps\u002Fpackages directories.\n",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1588,1589,1590],{"name":1503,"slug":1504,"type":13},{"name":1475,"slug":1476,"type":13},{"name":21,"slug":22,"type":13},30809,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fturborepo","2026-07-30T05:32:14.920116",{"slug":1595,"name":1595,"fn":1596,"description":1597,"org":1598,"tags":1599,"stars":1605,"repoUrl":1606,"updatedAt":1607},"add-function-examples","add AI function examples for testing","Guide for adding new AI function examples, for testing specific features against the actual provider APIs.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1600,1603,1604],{"name":1601,"slug":1602,"type":13},"AI SDK","ai-sdk",{"name":1234,"slug":1231,"type":13},{"name":9,"slug":8,"type":13},25670,"https:\u002F\u002Fgithub.com\u002Fvercel\u002Fai","2026-04-06T18:55:51.318866",{"slug":1609,"name":1609,"fn":1610,"description":1611,"org":1612,"tags":1613,"stars":1605,"repoUrl":1606,"updatedAt":1621},"add-harness-package","add AI SDK harness packages","Guide for adding new AI SDK harness packages. Use when creating a new @ai-sdk\u002Fharness-\u003Cname> package that adapts a coding-agent runtime to HarnessV1.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1614,1615,1616,1619,1620],{"name":1486,"slug":1487,"type":13},{"name":1601,"slug":1602,"type":13},{"name":1617,"slug":1618,"type":13},"Harness","harness",{"name":1492,"slug":1493,"type":13},{"name":9,"slug":8,"type":13},"2026-06-18T08:29:19.858737",{"slug":1623,"name":1623,"fn":1624,"description":1625,"org":1626,"tags":1627,"stars":1605,"repoUrl":1606,"updatedAt":1633},"add-provider-package","add new provider packages to AI SDK","Guide for adding new AI provider packages to the AI SDK. Use when creating a new @ai-sdk\u002F\u003Cprovider> package to integrate an AI service into the SDK.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1628,1629,1632],{"name":1601,"slug":1602,"type":13},{"name":1630,"slug":1631,"type":13},"API Development","api-development",{"name":9,"slug":8,"type":13},"2026-04-06T18:55:47.45549",{"slug":1635,"name":1635,"fn":1636,"description":1637,"org":1638,"tags":1639,"stars":1605,"repoUrl":1606,"updatedAt":1652},"adr-skill","create and maintain architecture decision records","Create and maintain Architecture Decision Records (ADRs) optimized for agentic coding workflows. Use when you need to propose, write, update, accept\u002Freject, deprecate, or supersede an ADR; bootstrap an adr folder and index; consult existing ADRs before implementing changes; or enforce ADR conventions. This skill uses Socratic questioning to capture intent before drafting, and validates output against an agent-readiness checklist.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1640,1643,1646,1649],{"name":1641,"slug":1642,"type":13},"ADR","adr",{"name":1644,"slug":1645,"type":13},"Architecture","architecture",{"name":1647,"slug":1648,"type":13},"Documentation","documentation",{"name":1650,"slug":1651,"type":13},"Engineering","engineering","2026-04-06T18:55:50.043694",{"slug":1602,"name":1602,"fn":1654,"description":1655,"org":1656,"tags":1657,"stars":1605,"repoUrl":1606,"updatedAt":1662},"build AI features with Vercel AI SDK","Answer questions about the AI SDK and help build AI-powered features. Use when developers: (1) Ask about AI SDK functions like generateText, streamText, ToolLoopAgent, embed, or tools, (2) Want to build AI agents, chatbots, RAG systems, or text generation features, (3) Have questions about AI providers (OpenAI, Anthropic, Google, etc.), streaming, tool calling, structured output, or embeddings, (4) Use React hooks like useChat or useCompletion. Triggers on: \"AI SDK\", \"Vercel AI SDK\", \"generateText\", \"streamText\", \"add AI to my app\", \"build an agent\", \"tool calling\", \"structured output\", \"useChat\".",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1658,1659,1660,1661],{"name":1486,"slug":1487,"type":13},{"name":1601,"slug":1602,"type":13},{"name":1428,"slug":1429,"type":13},{"name":9,"slug":8,"type":13},"2026-04-06T18:55:48.739463",{"slug":1664,"name":1664,"fn":1665,"description":1666,"org":1667,"tags":1668,"stars":1605,"repoUrl":1606,"updatedAt":1672},"capture-api-response-test-fixture","capture API response test fixtures","Capture API response test fixture.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1669,1670,1671],{"name":1630,"slug":1631,"type":13},{"name":1234,"slug":1231,"type":13},{"name":9,"slug":8,"type":13},"2026-04-06T18:55:56.374433",{"slug":1674,"name":1674,"fn":1675,"description":1676,"org":1677,"tags":1678,"stars":1605,"repoUrl":1606,"updatedAt":1682},"develop-ai-functions-example","develop AI SDK function examples","Develop examples for AI SDK functions. Use when creating, running, or modifying examples under examples\u002Fai-functions\u002Fsrc to validate provider support, demonstrate features, or create test fixtures.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":8},[1679,1680,1681],{"name":1601,"slug":1602,"type":13},{"name":1234,"slug":1231,"type":13},{"name":9,"slug":8,"type":13},"2026-04-06T18:55:55.088956",68]