[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7E8EZGPD031XYQRTD5SY8AX":3,"skill-same:01M7E8EZGPD031XYQRTD5SY8AX":141},{"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":118,"ownerDescription":119,"updatedAt":120,"install":121,"resources":134},"01M7E8EZGPD031XYQRTD5SY8AX","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.","wxdwu\u002Fnew-api","wxdwu","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F80968397?v=4","01M7E6AEMB59N90BKXD77EC83D","Xudong Wu","01M7E6AEMY2BXCDVZ9MJJHFQ4C",0,"AGPL-3.0","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fvercel\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","dde9a06ab10bce3fe52058c783826590231f7df3","plugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fvercel\u002Fskills\u002Fnext-forge","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api","https:\u002F\u002Fgithub.com\u002Fwxdwu","24120128@bjtu.edu.cn","I am Xudong Wu，a student in beijing jiaotong University, \"I am eager to learn on GitHub and contribute my part to this community.","2026-10-05 17:26:50",{"source":8,"skillName":5,"commands":122,"prompt":132,"zipAvailable":133},[123,126,129],{"tool":124,"command":125},"npx","npx skills add wxdwu\u002Fnew-api --skill next-forge",{"tool":127,"command":128},"bunx","bunx skills add wxdwu\u002Fnew-api --skill next-forge",{"tool":130,"command":131},"pnpm","pnpm dlx skills add wxdwu\u002Fnew-api --skill next-forge","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fvercel\u002Fskills\u002Fnext-forge\u002FSKILL.md",true,[135],{"path":136,"resourceType":137,"resourceTypeDesc":138,"sizeBytes":139,"sourceHtmlUrl":140},"agents\u002Fopenai.yaml","REFERENCE","参考文档",154,"https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fvercel\u002Fskills\u002Fnext-forge\u002Fagents\u002Fopenai.yaml",[142,149,156,163,170,177],{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":148,"publishedAt":19},"01M7E8SVA2N0JA09RW1XJYXCWX","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\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzotero\u002Fskills\u002Fzotero\u002FSKILL.md",[],[],{"skillNo":150,"name":151,"nameZh":6,"description":152,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":153,"categories":154,"keywords":155,"publishedAt":19},"01M7E8ST1FJAD5PWTW2FN1NSK0","zoom-apps-sdk","Use when using Apps SDK.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fzoom-apps-sdk\u002FSKILL.md",[],[],{"skillNo":157,"name":158,"nameZh":6,"description":159,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":160,"categories":161,"keywords":162,"publishedAt":19},"01M7E8SRW074NNNCZRCZA5T3Z1","setup-zoom-websockets","Use when building Zoom WebSockets.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fwebsockets\u002FSKILL.md",[],[],{"skillNo":164,"name":165,"nameZh":6,"description":166,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":167,"categories":168,"keywords":169,"publishedAt":19},"01M7E8SPCFMD3YVPRX2MW8X3RA","setup-zoom-webhooks","Use when building Zoom webhooks.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fwebhooks\u002FSKILL.md",[],[],{"skillNo":171,"name":172,"nameZh":6,"description":173,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":174,"categories":175,"keywords":176,"publishedAt":19},"01M7E8SMCH4RPCX8YSBNGWQCMP","zoom-virtual-agent-web","Zoom Virtual Agent SDK for web embeds. Use for campaign or entry ID chat launch, event-driven controls, user context updates, and CSP-safe deployment.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fvirtual-agent\u002Fweb\u002FSKILL.md",[],[],{"skillNo":178,"name":179,"nameZh":6,"description":180,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":181,"categories":182,"keywords":183,"publishedAt":19},"01M7E8SJCAY323E36Z8SAP8H4M","zoom-virtual-agent-ios","Zoom Virtual Agent iOS integration via WKWebView. Use for Swift\u002FObjective-C script injection, message handlers, support_handoff relay, and URL routing policies.","https:\u002F\u002Fgithub.com\u002Fwxdwu\u002Fnew-api\u002Fblob\u002Fmain\u002Fplugins\u002F.tmp\u002Fplugins\u002Fplugins\u002Fzoom\u002Fskills\u002Fvirtual-agent\u002Fios\u002FSKILL.md",[],[]]