Chapters

00 · Root Layout

Global shell, providers only, no domain logic or Prisma.

01 · Server Page (page.tsx)

Read-only orchestration: fetch via get*, enforce visibility, pass promises to UI.

02 · Client Component (UI & Interaction)

Interactive UI only: render/react and call server actions; never fetch or decide business rules.

03 · Entity Actions (actions/*.ts)

Server authority over data: Prisma lives here; validate, authorize, and expose get*/mutations.

04 · Server Actions ("use server")

Mutation entry points: adapt UI input, call entity actions, trigger revalidation.

05 · Context Provider (context/*.tsx)

UI state sharing only: convenience, not authority; never fetch or mutate data.

06 · API Route (app/(api)/<entity>/route.ts)

External contract only: adapt HTTP → entity actions; never used by internal UI.

07 · TypeScript + Prisma

Prisma models storage; TypeScript models intent. Keep them related but distinct.

08 · Entity-First Feature Design

One folder = one entity. Logic lives with the entity, routes are UX-only.

09 · Deployment, Docker & Cloud

Treat deployment as a contract: build, run, migrate, seed; keep steps explicit.

10 · Next 16 + Prisma 7 Upgrade

Prereqs, config, and client patterns for Prisma 7 (adapter-first) on Next 16.

11 · Prisma 7 (SQLite-first, App Router)

Prisma 7 setup for Next 14–16: env, schema, client, upgrade path, and rules of use.

12 · TypeORM (Entities + Migrations)

TypeORM quickstart for Next: entities, data source, usage, and migration guidance.

13 · Drizzle ORM (SQL-first)

Drizzle quickstart for App Router: schema, client, and query patterns.

11 · CSS, Mobile-First Flex, Tailwind

Pragmatic styling stack: global CSS tokens, mobile-first flex/grid, and Tailwind when it saves time.

12 · Libraries, Accelerators & Production Shortcuts