Next.js + Drizzle + Clerk Vertical Slice

End-to-end outline for the saas-multi-tenant playbook: auth, tenant-scoped Drizzle queries, and server actions. Prefer the playbook and stack instructions for detail.

Copilot ✓Cursor ✓Kilo ✓
AuthorNeexoCore
Updated
nextjsdrizzleclerk

Overview

Thin outline for the saas-multi-tenant playbook. Canonical detail lives in:

Vertical slice

  1. Auth — protect routes with Clerk (proxy.ts on Node; Edge middleware.ts when required — see clerk-auth)
  2. Auth context — resolve userId and orgId once; reuse everywhere
  3. Schema — tables include orgId; indexes for tenant filters
  4. Scoped query — never query tenant data without org scope
  5. Server action — validate with Zod v4 (prefer import { z } from "zod/v4"); re-check org membership before writes
  6. Validate — run the project gate (pnpm ci:check or documented fallback)

SaaS apps that also ship React Three Fiber / next-intl marketing surfaces may additionally load marketing-3d-site resources.

Raw content

Copy into your project — e.g. .instructions.md, .agent.md, or SKILL.md

## Overview

Thin outline for the [`saas-multi-tenant`](/playbooks/saas-multi-tenant) playbook. Canonical detail lives in:

- [Clerk Authentication](/instructions/clerk-auth)
- [Drizzle Database](/instructions/drizzle-database)
- [Zod v4 Validation](/instructions/zod-v4)
- [Next.js Conventions](/instructions/nextjs-conventions)

## Vertical slice

1. **Auth** — protect routes with Clerk (`proxy.ts` on Node; Edge `middleware.ts` when required — see clerk-auth)
2. **Auth context** — resolve `userId` and `orgId` once; reuse everywhere
3. **Schema** — tables include `orgId`; indexes for tenant filters
4. **Scoped query** — never query tenant data without org scope
5. **Server action** — validate with Zod v4 (prefer `import { z } from "zod/v4"`); re-check org membership before writes
6. **Validate** — run the project gate (`pnpm ci:check` or documented fallback)

SaaS apps that also ship React Three Fiber / next-intl marketing surfaces may additionally load [`marketing-3d-site`](/playbooks/marketing-3d-site) resources.

Next steps

Copy export prompt

Agent fetches /api/export?ids=cookbook/nextjs-drizzle-clerk-stack

Agent entry point

Search the hub

Find related resources with Cmd+K.

Open search

Related resources

Clerk Authentication

Authentication patterns for Next.js apps using Clerk, including proxy/middleware setup, role-based access, organization scoping, and dev-mode fallbacks.

Copilot ✓Cursor ✓Kilo ✓
authclerknextjs

Upgrade a Neexo Site to Next.js 16

A migration checklist for moving Neexo Next.js apps to Next.js 16, React 19, async route params, and updated caching.

Copilot ✓Cursor ✓Kilo ✓
nextjsupgradereact

Neexo Drizzle Database Instructions

Database and migration guidance for Drizzle ORM, Drizzle Kit, Neon, tenant-scoped queries, atomic schema changes, and production-safe data access.

Copilot ✓Cursor ✓Kilo ✓
databasedrizzleneon

Neexo Next.js Conventions

Shared App Router, React 19, TypeScript, UI, and validation conventions for Neexo's Next.js 16 projects, including agent-first docs and DevTools MCP.

Copilot ✓Cursor ✓Kilo ✓
nextjsreacttypescript

Matched by shared tags and category. Browse all instructions