[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79EXA04C2FXYJCMG2C4D17E":3,"skill-same:01M79EXA04C2FXYJCMG2C4D17E":140},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":113,"commitSha":114,"skillDirectory":115,"forksCount":14,"repositoryHtmlUrl":116,"repositoryHomepageUrl":6,"ownerHtmlUrl":117,"ownerBlogUrl":6,"ownerDescription":118,"updatedAt":119,"install":120,"resources":133},"01M79EXA04C2FXYJCMG2C4D17E","next-forge",null,"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.","zfifteen\u002Fskills-catalog","zfifteen","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F221906715?v=4","01M79CQFXDZM5J5CJTCECPFA66","Dionisio Alberto Lopez III","01M79CQFY4C62PN8A2T5KDAHGA",1,"MIT","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fnext-forge\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\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.'\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\n---\n\n# next-forge\n\nYou are an expert in next-forge v5 — a production-grade Turborepo monorepo starter for SaaS applications, created by Vercel. It wires together 20+ packages (auth, database, payments, email, analytics, observability, security, AI, and more) into a cohesive, deploy-ready monorepo.\n\n## Monorepo Structure\n\n```\n├── apps\u002F\n│   ├── app\u002F          # Main SaaS app (port 3000) — Clerk auth, route groups\n│   ├── web\u002F          # Marketing site (port 3001) — blog, pricing, i18n\n│   ├── api\u002F          # API server (port 3002) — webhooks, cron jobs\n│   ├── email\u002F        # React Email preview (port 3003)\n│   ├── docs\u002F         # Mintlify docs\n│   ├── studio\u002F       # Prisma Studio\n│   └── storybook\u002F    # Component dev (port 6006)\n├── packages\u002F\n│   ├── ai\u002F               # @repo\u002Fai — AI SDK + OpenAI\n│   ├── analytics\u002F        # @repo\u002Fanalytics — PostHog + GA + Vercel Analytics\n│   ├── auth\u002F             # @repo\u002Fauth — Clerk\n│   ├── cms\u002F              # @repo\u002Fcms — BaseHub\n│   ├── collaboration\u002F    # @repo\u002Fcollaboration — Liveblocks\n│   ├── database\u002F         # @repo\u002Fdatabase — Prisma + Neon\n│   ├── design-system\u002F    # @repo\u002Fdesign-system — shadcn\u002Fui + Geist\n│   ├── email\u002F            # @repo\u002Femail — Resend + React Email\n│   ├── feature-flags\u002F    # @repo\u002Ffeature-flags — Vercel Flags SDK\n│   ├── internationalization\u002F # @repo\u002Finternationalization — next-international\n│   ├── next-config\u002F      # @repo\u002Fnext-config — shared Next.js config\n│   ├── notifications\u002F    # @repo\u002Fnotifications — Knock\n│   ├── observability\u002F    # @repo\u002Fobservability — Sentry + BetterStack\n│   ├── payments\u002F         # @repo\u002Fpayments — Stripe\n│   ├── rate-limit\u002F       # @repo\u002Frate-limit — Upstash Redis\n│   ├── security\u002F         # @repo\u002Fsecurity — Arcjet + Nosecone\n│   ├── seo\u002F              # @repo\u002Fseo — metadata + JSON-LD\n│   ├── storage\u002F          # @repo\u002Fstorage — Vercel Blob\n│   ├── typescript-config\u002F # @repo\u002Ftypescript-config\n│   └── webhooks\u002F         # @repo\u002Fwebhooks — Svix\n├── turbo.json\n├── pnpm-workspace.yaml\n└── biome.jsonc           # Biome via ultracite\n```\n\n**Key principle**: Packages are self-contained — they do not depend on each other. Apps compose packages.\n\n## Getting Started\n\n```bash\nnpx next-forge@latest init     # Scaffold project (interactive)\n# Post-install:\npnpm migrate                   # prisma format + generate + db push\npnpm dev                       # Start all apps via turbo\n```\n\n**Minimum env vars to run locally**: `DATABASE_URL` + Clerk keys + app URLs. Everything else is optional.\n\n## Workspace Imports (@repo\u002F*)\n\nAll packages use `@repo\u002F*` workspace protocol with specific subpath exports:\n\n```ts\n\u002F\u002F Auth\nimport { auth } from \"@repo\u002Fauth\u002Fserver\";\nimport { ClerkProvider } from \"@repo\u002Fauth\u002Fprovider\";\nimport { currentUser } from \"@repo\u002Fauth\u002Fserver\";\n\n\u002F\u002F Database\nimport { database } from \"@repo\u002Fdatabase\";\n\n\u002F\u002F Design System\nimport { Button } from \"@repo\u002Fdesign-system\u002Fcomponents\u002Fui\u002Fbutton\";\nimport { DesignSystemProvider } from \"@repo\u002Fdesign-system\";\nimport { fonts } from \"@repo\u002Fdesign-system\u002Flib\u002Ffonts\";\n\n\u002F\u002F Payments\nimport { stripe } from \"@repo\u002Fpayments\";\n\n\u002F\u002F Email\nimport { resend } from \"@repo\u002Femail\";\n\n\u002F\u002F Observability\nimport { log } from \"@repo\u002Fobservability\u002Flog\";\nimport { captureException } from \"@repo\u002Fobservability\u002Ferror\";\n\n\u002F\u002F Analytics\nimport { AnalyticsProvider } from \"@repo\u002Fanalytics\u002Fprovider\";\n\n\u002F\u002F Security\nimport { secure } from \"@repo\u002Fsecurity\";\n\n\u002F\u002F Feature Flags\nimport { createFlag } from \"@repo\u002Ffeature-flags\";\n\n\u002F\u002F SEO\nimport { createMetadata } from \"@repo\u002Fseo\u002Fmetadata\";\nimport { JsonLd } from \"@repo\u002Fseo\u002Fjson-ld\";\n\n\u002F\u002F Storage\nimport { put } from \"@repo\u002Fstorage\";\n\n\u002F\u002F AI\nimport { models } from \"@repo\u002Fai\u002Flib\u002Fmodels\";\n```\n\n## Environment Variables\n\n### Type-safe env validation\n\nEvery package has a `keys.ts` using `@t3-oss\u002Fenv-nextjs` + Zod. Apps compose them in `env.ts`:\n\n```ts\n\u002F\u002F apps\u002Fapp\u002Fenv.ts\nimport { createEnv } from \"@t3-oss\u002Fenv-nextjs\";\nimport { auth } from \"@repo\u002Fauth\u002Fkeys\";\nimport { database } from \"@repo\u002Fdatabase\u002Fkeys\";\nimport { payments } from \"@repo\u002Fpayments\u002Fkeys\";\nexport const env = createEnv({ extends: [auth(), database(), payments()] });\n```\n\n### Env file locations\n\n| File | Purpose |\n|------|---------|\n| `apps\u002Fapp\u002F.env.local` | Main app env vars |\n| `apps\u002Fweb\u002F.env.local` | Marketing site |\n| `apps\u002Fapi\u002F.env.local` | API server |\n| `packages\u002Fdatabase\u002F.env` | `DATABASE_URL` |\n\n### Required env vars (minimum)\n\n| Var | Package | Required for |\n|-----|---------|-------------|\n| `DATABASE_URL` | database | Any database access |\n| `CLERK_SECRET_KEY` | auth | Authentication |\n| `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` | auth | Client-side auth |\n| `NEXT_PUBLIC_APP_URL` | — | Cross-app linking |\n| `NEXT_PUBLIC_WEB_URL` | — | Cross-app linking |\n| `NEXT_PUBLIC_API_URL` | — | Cross-app linking |\n\n### Optional service env vars\n\n| Service | Vars |\n|---------|------|\n| Stripe | `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET` |\n| Resend | `RESEND_TOKEN`, `RESEND_FROM` |\n| PostHog | `NEXT_PUBLIC_POSTHOG_KEY`, `NEXT_PUBLIC_POSTHOG_HOST` |\n| Sentry | `NEXT_PUBLIC_SENTRY_DSN`, `SENTRY_ORG`, `SENTRY_PROJECT` |\n| BetterStack | `BETTERSTACK_API_KEY`, `BETTERSTACK_URL` |\n| BaseHub | `BASEHUB_TOKEN` |\n| Arcjet | `ARCJET_KEY` |\n| Liveblocks | `LIVEBLOCKS_SECRET` |\n| Knock | `KNOCK_SECRET_API_KEY`, `NEXT_PUBLIC_KNOCK_API_KEY` |\n| Upstash | `UPSTASH_REDIS_REST_URL`, `UPSTASH_REDIS_REST_TOKEN` |\n| Vercel Blob | `BLOB_READ_WRITE_TOKEN` |\n| Svix | `SVIX_TOKEN` |\n| OpenAI | `OPENAI_API_KEY` |\n| Feature Flags | `FLAGS_SECRET` |\n\n## Middleware \u002F Proxy Pattern\n\nnext-forge uses `proxy.ts` (Next.js 16+), NOT `middleware.ts`:\n\n```ts\n\u002F\u002F apps\u002Fapp\u002Fproxy.ts — Clerk auth + Nosecone security\nimport { clerkMiddleware } from \"@clerk\u002Fnextjs\u002Fserver\";\nimport { createMiddleware as createNosecone } from \"@nosecone\u002Fnext\";\nexport default clerkMiddleware(createNosecone());\n```\n\n```ts\n\u002F\u002F apps\u002Fweb\u002Fproxy.ts — Clerk + i18n + Arcjet + Nosecone, composed with nemo\nimport { compose } from \"@rescale\u002Fnemo\";\nexport default compose([clerkMiddleware, i18nMiddleware, arcjetMiddleware, noseconeMiddleware]);\n```\n\n## Database (Prisma + Neon)\n\n- Schema: `packages\u002Fdatabase\u002Fprisma\u002Fschema.prisma`\n- Client: `import { database } from \"@repo\u002Fdatabase\"`\n- Config: `packages\u002Fdatabase\u002Fprisma.config.ts` (Neon adapter)\n- Commands: `pnpm migrate` (format + generate + db push)\n- Studio: `apps\u002Fstudio` (Prisma Studio)\n\n## Key Commands\n\n| Command | Purpose |\n|---------|---------|\n| `pnpm dev` | Start all apps |\n| `pnpm dev --filter app` | Start single app |\n| `pnpm build` | Build all |\n| `pnpm migrate` | Prisma format + generate + db push |\n| `pnpm bump-deps` | Update all dependencies |\n| `pnpm bump-ui` | Update shadcn\u002Fui components |\n| `pnpm run boundaries` | Check Turborepo boundaries |\n| `npx next-forge@latest update` | Update next-forge (diff-based) |\n| `npx shadcn@latest add \u003Ccomp> -c packages\u002Fdesign-system` | Add UI component |\n| `stripe listen --forward-to localhost:3002\u002Fwebhooks\u002Fpayments` | Local Stripe webhooks |\n\n## Deployment to Vercel\n\nDeploy as **3 separate Vercel projects** (app, api, web), each with Root Directory set to `apps\u002F\u003Cname>`:\n\n1. Create project → set Root Directory to `apps\u002Fapp`\n2. Add environment variables (use Team Environment Variables to avoid duplication)\n3. Repeat for `apps\u002Fapi` and `apps\u002Fweb`\n\nRecommended subdomains: `app.yourdomain.com`, `api.yourdomain.com`, `www.yourdomain.com`\n\n## API App Patterns\n\n```\napps\u002Fapi\u002F\n├── app\u002F\n│   ├── cron\u002F           # Cron jobs (GET handlers)\n│   │   └── keep-alive\u002Froute.ts\n│   ├── webhooks\u002F       # Inbound webhooks\n│   │   ├── auth\u002Froute.ts      # Clerk webhooks\n│   │   └── payments\u002Froute.ts  # Stripe webhooks\n│   └── health\u002Froute.ts\n└── vercel.json         # Cron schedules\n```\n\n## Design System\n\n- shadcn\u002Fui (New York style, neutral palette)\n- Geist Sans + Geist Mono fonts\n- Tailwind CSS v4 + tw-animate-css\n- Components at `packages\u002Fdesign-system\u002Fcomponents\u002Fui\u002F`\n- Add components: `npx shadcn@latest add \u003Cname> -c packages\u002Fdesign-system`\n\n## Common Gotchas\n\n1. **Env vars are validated at build time** — optional services still require env vars if the package is imported. Remove the import or provide a value.\n2. **Multiple .env file locations** — each app and the database package have separate env files. There is no single root `.env`.\n3. **`pnpm migrate` before first run** — without this, you get \"table does not exist\" errors.\n4. **Clerk webhooks cannot be tested locally** — need a staging deployment.\n5. **Heavy middleware imports** → edge function >1MB on Vercel. Keep proxy.ts imports light.\n6. **Prisma v7**: use `--config` not `--schema` for `prisma studio`.\n7. **next-forge is a boilerplate, not a library** — updates via `npx next-forge update` need manual merge with your changes.\n8. **`turbo.json` globalEnv** — when adding new env vars used at build time, declare them in `turbo.json` `globalEnv` or they won't invalidate cache.\n\n## Removing Optional Services\n\nTo remove an unused service (e.g., Stripe, BaseHub, Liveblocks):\n1. Delete the package directory (`packages\u002F\u003Cservice>\u002F`)\n2. Remove all `@repo\u002F\u003Cservice>` imports from apps\n3. Remove the `keys()` call from each app's `env.ts`\n4. Remove the workspace entry from `pnpm-workspace.yaml` if needed\n5. Run `pnpm install` to clean lockfile\n\n## Migration Alternatives\n\n| Category | Default | Alternatives |\n|----------|---------|-------------|\n| Auth | Clerk | Auth.js, Better Auth, Supabase Auth |\n| Database | Prisma + Neon | Drizzle, Supabase, PlanetScale, Turso |\n| Payments | Stripe | Lemon Squeezy, Paddle |\n| CMS | BaseHub | Content Collections |\n| Docs | Mintlify | Fumadocs |\n| Feature Flags | Vercel Flags | Hypertune |\n| Storage | Vercel Blob | UploadThing |\n| Formatting | Biome | ESLint |\n\n## Cross-references\n\n=> skill: turborepo — Monorepo configuration, caching, remote cache\n=> skill: auth — Clerk setup, middleware patterns, sign-in\u002Fup flows\n=> skill: payments — Stripe integration, webhooks, pricing\n=> skill: email — Resend + React Email templates\n=> skill: shadcn — shadcn\u002Fui components, theming, CLI\n=> skill: observability — Sentry + logging setup\n=> skill: vercel-storage — Blob, Neon, Upstash\n=> skill: vercel-flags — Feature flags with Vercel Flags SDK\n=> skill: ai-sdk — AI SDK integration\n=> skill: bootstrap — Project bootstrapping flow\n\n## Official Documentation\n\n- https:\u002F\u002Fdocs.next-forge.com\n- https:\u002F\u002Fgithub.com\u002Fvercel\u002Fnext-forge\n","# next-forge\n\nYou are an expert in next-forge v5 — a production-grade Turborepo monorepo starter for SaaS applications, created by Vercel. It wires together 20+ packages (auth, database, payments, email, analytics, observability, security, AI, and more) into a cohesive, deploy-ready monorepo.\n\n## Monorepo Structure\n\n```\n├── apps\u002F\n│   ├── app\u002F          # Main SaaS app (port 3000) — Clerk auth, route groups\n│   ├── web\u002F          # Marketing site (port 3001) — blog, pricing, i18n\n│   ├── api\u002F          # API server (port 3002) — webhooks, cron jobs\n│   ├── email\u002F        # React Email preview (port 3003)\n│   ├── docs\u002F         # Mintlify docs\n│   ├── studio\u002F       # Prisma Studio\n│   └── storybook\u002F    # Component dev (port 6006)\n├── packages\u002F\n│   ├── ai\u002F               # @repo\u002Fai — AI SDK + OpenAI\n│   ├── analytics\u002F        # @repo\u002Fanalytics — PostHog + GA + Vercel Analytics\n│   ├── auth\u002F             # @repo\u002Fauth — Clerk\n│   ├── cms\u002F              # @repo\u002Fcms — BaseHub\n│   ├── collaboration\u002F    # @repo\u002Fcollaboration — Liveblocks\n│   ├── database\u002F         # @repo\u002Fdatabase — Prisma + Neon\n│   ├── design-system\u002F    # @repo\u002Fdesign-system — shadcn\u002Fui + Geist\n│   ├── email\u002F            # @repo\u002Femail — Resend + React Email\n│   ├── feature-flags\u002F    # @repo\u002Ffeature-flags — Vercel Flags SDK\n│   ├── internationalization\u002F # @repo\u002Finternationalization — next-international\n│   ├── next-config\u002F      # @repo\u002Fnext-config — shared Next.js config\n│   ├── notifications\u002F    # @repo\u002Fnotifications — Knock\n│   ├── observability\u002F    # @repo\u002Fobservability — Sentry + BetterStack\n│   ├── payments\u002F         # @repo\u002Fpayments — Stripe\n│   ├── rate-limit\u002F       # @repo\u002Frate-limit — Upstash Redis\n│   ├── security\u002F         # @repo\u002Fsecurity — Arcjet + Nosecone\n│   ├── seo\u002F              # @repo\u002Fseo — metadata + JSON-LD\n│   ├── storage\u002F          # @repo\u002Fstorage — Vercel Blob\n│   ├── typescript-config\u002F # @repo\u002Ftypescript-config\n│   └── webhooks\u002F         # @repo\u002Fwebhooks — Svix\n├── turbo.json\n├── pnpm-workspace.yaml\n└── biome.jsonc           # Biome via ultracite\n```\n\n**Key principle**: Packages are self-contained — they do not depend on each other. Apps compose packages.\n\n## Getting Started\n\n```bash\nnpx next-forge@latest init     # Scaffold project (interactive)\n# Post-install:\npnpm migrate                   # prisma format + generate + db push\npnpm dev                       # Start all apps via turbo\n```\n\n**Minimum env vars to run locally**: `DATABASE_URL` + Clerk keys + app URLs. Everything else is optional.\n\n## Workspace Imports (@repo\u002F*)\n\nAll packages use `@repo\u002F*` workspace protocol with specific subpath exports:\n\n```ts\n\u002F\u002F Auth\nimport { auth } from \"@repo\u002Fauth\u002Fserver\";\nimport { ClerkProvider } from \"@repo\u002Fauth\u002Fprovider\";\nimport { currentUser } from \"@repo\u002Fauth\u002Fserver\";\n\n\u002F\u002F Database\nimport { database } from \"@repo\u002Fdatabase\";\n\n\u002F\u002F Design System\nimport { Button } from \"@repo\u002Fdesign-system\u002Fcomponents\u002Fui\u002Fbutton\";\nimport { DesignSystemProvider } from \"@repo\u002Fdesign-system\";\nimport { fonts } from \"@repo\u002Fdesign-system\u002Flib\u002Ffonts\";\n\n\u002F\u002F Payments\nimport { stripe } from \"@repo\u002Fpayments\";\n\n\u002F\u002F Email\nimport { resend } from \"@repo\u002Femail\";\n\n\u002F\u002F Observability\nimport { log } from \"@repo\u002Fobservability\u002Flog\";\nimport { captureException } from \"@repo\u002Fobservability\u002Ferror\";\n\n\u002F\u002F Analytics\nimport { AnalyticsProvider } from \"@repo\u002Fanalytics\u002Fprovider\";\n\n\u002F\u002F Security\nimport { secure } from \"@repo\u002Fsecurity\";\n\n\u002F\u002F Feature Flags\nimport { createFlag } from \"@repo\u002Ffeature-flags\";\n\n\u002F\u002F SEO\nimport { createMetadata } from \"@repo\u002Fseo\u002Fmetadata\";\nimport { JsonLd } from \"@repo\u002Fseo\u002Fjson-ld\";\n\n\u002F\u002F Storage\nimport { put } from \"@repo\u002Fstorage\";\n\n\u002F\u002F AI\nimport { models } from \"@repo\u002Fai\u002Flib\u002Fmodels\";\n```\n\n## Environment Variables\n\n### Type-safe env validation\n\nEvery package has a `keys.ts` using `@t3-oss\u002Fenv-nextjs` + Zod. Apps compose them in `env.ts`:\n\n```ts\n\u002F\u002F apps\u002Fapp\u002Fenv.ts\nimport { createEnv } from \"@t3-oss\u002Fenv-nextjs\";\nimport { auth } from \"@repo\u002Fauth\u002Fkeys\";\nimport { database } from \"@repo\u002Fdatabase\u002Fkeys\";\nimport { payments } from \"@repo\u002Fpayments\u002Fkeys\";\nexport const env = createEnv({ extends: [auth(), database(), payments()] });\n```\n\n### Env file locations\n\n| File | Purpose |\n|------|---------|\n| `apps\u002Fapp\u002F.env.local` | Main app env vars |\n| `apps\u002Fweb\u002F.env.local` | Marketing site |\n| `apps\u002Fapi\u002F.env.local` | API server |\n| `packages\u002Fdatabase\u002F.env` | `DATABASE_URL` |\n\n### Required env vars (minimum)\n\n| Var | Package | Required for |\n|-----|---------|-------------|\n| `DATABASE_URL` | database | Any database access |\n| `CLERK_SECRET_KEY` | auth | Authentication |\n| `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` | auth | Client-side auth |\n| `NEXT_PUBLIC_APP_URL` | — | Cross-app linking |\n| `NEXT_PUBLIC_WEB_URL` | — | Cross-app linking |\n| `NEXT_PUBLIC_API_URL` | — | Cross-app linking |\n\n### Optional service env vars\n\n| Service | Vars |\n|---------|------|\n| Stripe | `STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET` |\n| Resend | `RESEND_TOKEN`, `RESEND_FROM` |\n| PostHog | `NEXT_PUBLIC_POSTHOG_KEY`, `NEXT_PUBLIC_POSTHOG_HOST` |\n| Sentry | `NEXT_PUBLIC_SENTRY_DSN`, `SENTRY_ORG`, `SENTRY_PROJECT` |\n| BetterStack | `BETTERSTACK_API_KEY`, `BETTERSTACK_URL` |\n| BaseHub | `BASEHUB_TOKEN` |\n| Arcjet | `ARCJET_KEY` |\n| Liveblocks | `LIVEBLOCKS_SECRET` |\n| Knock | `KNOCK_SECRET_API_KEY`, `NEXT_PUBLIC_KNOCK_API_KEY` |\n| Upstash | `UPSTASH_REDIS_REST_URL`, `UPSTASH_REDIS_REST_TOKEN` |\n| Vercel Blob | `BLOB_READ_WRITE_TOKEN` |\n| Svix | `SVIX_TOKEN` |\n| OpenAI | `OPENAI_API_KEY` |\n| Feature Flags | `FLAGS_SECRET` |\n\n## Middleware \u002F Proxy Pattern\n\nnext-forge uses `proxy.ts` (Next.js 16+), NOT `middleware.ts`:\n\n```ts\n\u002F\u002F apps\u002Fapp\u002Fproxy.ts — Clerk auth + Nosecone security\nimport { clerkMiddleware } from \"@clerk\u002Fnextjs\u002Fserver\";\nimport { createMiddleware as createNosecone } from \"@nosecone\u002Fnext\";\nexport default clerkMiddleware(createNosecone());\n```\n\n```ts\n\u002F\u002F apps\u002Fweb\u002Fproxy.ts — Clerk + i18n + Arcjet + Nosecone, composed with nemo\nimport { compose } from \"@rescale\u002Fnemo\";\nexport default compose([clerkMiddleware, i18nMiddleware, arcjetMiddleware, noseconeMiddleware]);\n```\n\n## Database (Prisma + Neon)\n\n- Schema: `packages\u002Fdatabase\u002Fprisma\u002Fschema.prisma`\n- Client: `import { database } from \"@repo\u002Fdatabase\"`\n- Config: `packages\u002Fdatabase\u002Fprisma.config.ts` (Neon adapter)\n- Commands: `pnpm migrate` (format + generate + db push)\n- Studio: `apps\u002Fstudio` (Prisma Studio)\n\n## Key Commands\n\n| Command | Purpose |\n|---------|---------|\n| `pnpm dev` | Start all apps |\n| `pnpm dev --filter app` | Start single app |\n| `pnpm build` | Build all |\n| `pnpm migrate` | Prisma format + generate + db push |\n| `pnpm bump-deps` | Update all dependencies |\n| `pnpm bump-ui` | Update shadcn\u002Fui components |\n| `pnpm run boundaries` | Check Turborepo boundaries |\n| `npx next-forge@latest update` | Update next-forge (diff-based) |\n| `npx shadcn@latest add \u003Ccomp> -c packages\u002Fdesign-system` | Add UI component |\n| `stripe listen --forward-to localhost:3002\u002Fwebhooks\u002Fpayments` | Local Stripe webhooks |\n\n## Deployment to Vercel\n\nDeploy as **3 separate Vercel projects** (app, api, web), each with Root Directory set to `apps\u002F\u003Cname>`:\n\n1. Create project → set Root Directory to `apps\u002Fapp`\n2. Add environment variables (use Team Environment Variables to avoid duplication)\n3. Repeat for `apps\u002Fapi` and `apps\u002Fweb`\n\nRecommended subdomains: `app.yourdomain.com`, `api.yourdomain.com`, `www.yourdomain.com`\n\n## API App Patterns\n\n```\napps\u002Fapi\u002F\n├── app\u002F\n│   ├── cron\u002F           # Cron jobs (GET handlers)\n│   │   └── keep-alive\u002Froute.ts\n│   ├── webhooks\u002F       # Inbound webhooks\n│   │   ├── auth\u002Froute.ts      # Clerk webhooks\n│   │   └── payments\u002Froute.ts  # Stripe webhooks\n│   └── health\u002Froute.ts\n└── vercel.json         # Cron schedules\n```\n\n## Design System\n\n- shadcn\u002Fui (New York style, neutral palette)\n- Geist Sans + Geist Mono fonts\n- Tailwind CSS v4 + tw-animate-css\n- Components at `packages\u002Fdesign-system\u002Fcomponents\u002Fui\u002F`\n- Add components: `npx shadcn@latest add \u003Cname> -c packages\u002Fdesign-system`\n\n## Common Gotchas\n\n1. **Env vars are validated at build time** — optional services still require env vars if the package is imported. Remove the import or provide a value.\n2. **Multiple .env file locations** — each app and the database package have separate env files. There is no single root `.env`.\n3. **`pnpm migrate` before first run** — without this, you get \"table does not exist\" errors.\n4. **Clerk webhooks cannot be tested locally** — need a staging deployment.\n5. **Heavy middleware imports** → edge function >1MB on Vercel. Keep proxy.ts imports light.\n6. **Prisma v7**: use `--config` not `--schema` for `prisma studio`.\n7. **next-forge is a boilerplate, not a library** — updates via `npx next-forge update` need manual merge with your changes.\n8. **`turbo.json` globalEnv** — when adding new env vars used at build time, declare them in `turbo.json` `globalEnv` or they won't invalidate cache.\n\n## Removing Optional Services\n\nTo remove an unused service (e.g., Stripe, BaseHub, Liveblocks):\n1. Delete the package directory (`packages\u002F\u003Cservice>\u002F`)\n2. Remove all `@repo\u002F\u003Cservice>` imports from apps\n3. Remove the `keys()` call from each app's `env.ts`\n4. Remove the workspace entry from `pnpm-workspace.yaml` if needed\n5. Run `pnpm install` to clean lockfile\n\n## Migration Alternatives\n\n| Category | Default | Alternatives |\n|----------|---------|-------------|\n| Auth | Clerk | Auth.js, Better Auth, Supabase Auth |\n| Database | Prisma + Neon | Drizzle, Supabase, PlanetScale, Turso |\n| Payments | Stripe | Lemon Squeezy, Paddle |\n| CMS | BaseHub | Content Collections |\n| Docs | Mintlify | Fumadocs |\n| Feature Flags | Vercel Flags | Hypertune |\n| Storage | Vercel Blob | UploadThing |\n| Formatting | Biome | ESLint |\n\n## Cross-references\n\n=> skill: turborepo — Monorepo configuration, caching, remote cache\n=> skill: auth — Clerk setup, middleware patterns, sign-in\u002Fup flows\n=> skill: payments — Stripe integration, webhooks, pricing\n=> skill: email — Resend + React Email templates\n=> skill: shadcn — shadcn\u002Fui components, theming, CLI\n=> skill: observability — Sentry + logging setup\n=> skill: vercel-storage — Blob, Neon, Upstash\n=> skill: vercel-flags — Feature flags with Vercel Flags SDK\n=> skill: ai-sdk — AI SDK integration\n=> skill: bootstrap — Project bootstrapping flow\n\n## Official Documentation\n\n- https:\u002F\u002Fdocs.next-forge.com\n- https:\u002F\u002Fgithub.com\u002Fvercel\u002Fnext-forge\n",{"name":5,"metadata":24,"description":7},{"docs":25,"priority":28,"bashPatterns":29,"pathPatterns":38,"promptSignals":71,"importPatterns":91},[26,27],"https:\u002F\u002Fnext-forge.com\u002Fdocs","https:\u002F\u002Fgithub.com\u002Fhaydenbleasel\u002Fnext-forge",6,[30,31,32,33,34,35,36,37],"\\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",[39,40,41,42,43,44,45,46,47,48,49,50,51,52,53,54,55,56,57,58,59,60,61,62,63,64,65,66,67,68,69,70],"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",{"allOf":72,"anyOf":81,"noneOf":86,"phrases":88,"minScore":28},[73,77],[74,75,76],"monorepo","saas","starter",[78,79,80],"turborepo","clerk","stripe",[82,83,84,85],"saas starter","production monorepo","keys.ts","pnpm-workspace",[87],"create-t3-app",[5,89,90],"next forge","@repo\u002F",[92,93,94,95,96,97,98,99,100,101,102,103,104,105,106,107,108,109,110,111,112],"@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","main","d9535210da9af28aa76bca80de80355197e1b6d6","skills\u002Fnext-forge","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog","https:\u002F\u002Fgithub.com\u002Fzfifteen","I like to measure things.","2026-07-19 23:41:54",{"source":8,"skillName":5,"commands":121,"prompt":131,"zipAvailable":132},[122,125,128],{"tool":123,"command":124},"npx","npx skills add zfifteen\u002Fskills-catalog --skill next-forge",{"tool":126,"command":127},"bunx","bunx skills add zfifteen\u002Fskills-catalog --skill next-forge",{"tool":129,"command":130},"pnpm","pnpm dlx skills add zfifteen\u002Fskills-catalog --skill next-forge","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fnext-forge\u002FSKILL.md",true,[134],{"path":135,"resourceType":136,"resourceTypeDesc":137,"sizeBytes":138,"sourceHtmlUrl":139},"agents\u002Fopenai.yaml","REFERENCE","参考文档",154,"https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fnext-forge\u002Fagents\u002Fopenai.yaml",[141,148,155,162,171,178],{"skillNo":142,"name":143,"nameZh":6,"description":144,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":145,"categories":146,"keywords":147,"publishedAt":19},"01M79GXQ2PWPT2E4CJYHXVJ0YE","Zotero","Use Zotero Desktop from Codex to enable\u002Fprobe the local API, search a local Zotero library, list items\u002Fcollections\u002Ftags, export BibTeX, insert citation keys into LaTeX or Markdown drafts, read indexed full text when requested, and import BibTeX\u002FRIS records into Zotero through the connector server. Use when the user mentions Zotero, citations, references.bib, BibTeX export, local Zotero API, localhost:23119, or adding citations from a Zotero library.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzotero\u002FSKILL.md",[],[],{"skillNo":149,"name":150,"nameZh":6,"description":151,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":152,"categories":153,"keywords":154,"publishedAt":19},"01M79GXN85NETKBE06865CWK6Z","zoom-apps-sdk","Use when using Apps SDK.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[],{"skillNo":156,"name":157,"nameZh":6,"description":158,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":159,"categories":160,"keywords":161,"publishedAt":19},"01M79GXCYD7FGYS932J9N9RFFY","youtube","Obtain accurate, timestamped YouTube video transcripts (preferring manual captions over auto-generated) as the primary deliverable, then derive summaries, key claims, or notes from that transcript.  Use when the user provides a YouTube URL (or video ID) and wants the transcript, a faithful summary, key claims with attribution, timestamped notes, or \"what does this video actually say\".  The skill is transcript-first: never substitute metadata, title, description, or search snippets for the spoken content.  Triggers: \"youtube transcript\", \"get the transcript of this video\", \"summarize this youtube video\", \"what did they say in https:\u002F\u002Fyoutube.com\u002F...\", \"key claims from this talk\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyoutube\u002FSKILL.md",[],[],{"skillNo":163,"name":164,"nameZh":6,"description":165,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":166,"licenseFileUrl":167,"sourceHtmlUrl":168,"categories":169,"keywords":170,"publishedAt":19},"01M79GX8EXHHYM566BKR7MS778","yeet","Publish local changes to GitHub by confirming scope, committing intentionally, pushing the branch, and opening a draft PR through the GitHub app from this plugin, with `gh` used only as a fallback where connector coverage is insufficient.","Apache-2.0","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fyeet\u002FSKILL.md",[],[],{"skillNo":172,"name":173,"nameZh":6,"description":174,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":175,"categories":176,"keywords":177,"publishedAt":19},"01M79GX2HFJPX84NMRE5VBTYX9","x-post-creator","Create X-ready post threads and co-located story packages from the active conversation or referenced project material. Use when the user says turn this into an X-post, \u002Fx-post, make this into an X thread, or wants plain-language social posts with supporting images saved to docs\u002Fx-posts\u002F[story-name]\u002F.","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-post-creator\u002FSKILL.md",[],[],{"skillNo":179,"name":180,"nameZh":6,"description":181,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":182,"categories":183,"keywords":184,"publishedAt":19},"01M79GWXQT4HBT6QME6QSBZJFA","x-api","Search, read, and write X posts through the local X API MCP server (the same backend used by the Codex x-api skill). Use for searching X\u002Fx.com, reading threads and replies, creating lists, staging\u002Fpublishing posts for @alltheputs, finding high-visibility reply targets for research outreach, ingesting public context, or any request that mentions \u002Fx-api or \"search X\".","https:\u002F\u002Fgithub.com\u002Fzfifteen\u002Fskills-catalog\u002Fblob\u002Fmain\u002Fskills\u002Fx-api\u002FSKILL.md",[],[]]