Learn
Teaching guides for Effect v4, the RPC layer, auth, the database, and how this monorepo is wired — grounded in the real code.
The overview and architecture pages describe what the pieces are. These guides teach how and why — walking through the actual code in this repository so you can learn Effect v4 and your own monorepo at the same time.
Read them roughly in this order:
Your monorepo setup
pnpm workspaces + the version catalog, Turborepo, @repo/* packages, and the local quality gates.
Learn Effect v4
Effects vs Promises, services & layers, typed errors, Schema boundaries, Config, determinism, and concurrency — from the repo's own code.
The Effect RPC API layer
How *-schema.ts + handlers/ + the client replace tRPC, and how to add a new RPC.
How a request flows
One real request traced end to end: component → RPC client → route → auth → handler → repo → Postgres → typed result.
Authentication
Better Auth, the retry-safe session wrapper, and why raw getSession is banned.
Database & drizzle-kit
Drizzle schema, RLS, the Effect DB layer, and the generate/migrate/push workflow (and its traps).
The canonical Effect v4 reference is the vendored tools/effect-smol git subtree — it is pinned
to the exact beta this repo uses, so trust it over public docs and blog posts, which describe v3.