Introduction
Documentation for the albertonline.org monorepo — a personal product suite built as one type-safe monorepo on Next.js and Effect.
Welcome to the albertonline.org documentation. This is the developer handbook for the monorepo behind albertonline.org: a personal product suite (AI chat, image generation, a form builder, travel deals, agent plans, and more) plus a collection of side apps (chess, an e-commerce security lab, video/audio tooling), all built as one type-safe monorepo on Next.js + Effect.
What's in here
Monorepo overview
Structure, tooling, and the shared-code philosophy behind apps/ and packages/.
Architecture
Effect v4 RPC, Drizzle + Supabase, Better Auth, and how a request flows end to end.
Local development
Prerequisites, install, running apps, database, and testing.
Deployment
Where each app ships — Vercel and Cloudflare Workers.
CI/CD
The GitHub Actions workflows, the local pre-push gate, and quality gates.
Apps
What every app in apps/ does.
Packages
The shared libraries in packages/.
The stack at a glance
- Framework — Next.js (App Router, Turbopack) + React 19.
- Language — TypeScript in strict mode,
tsgo(the native TS 7 preview) for type-checking. - Effect system — Effect v4 for services, typed errors, schema-validated boundaries, and the RPC layer.
- Data — Drizzle ORM against Supabase Postgres, with RLS policies.
- Auth — Better Auth.
- Tooling — pnpm workspaces + Turborepo, oxlint + oxfmt, Vitest, react-doctor.
Start with the monorepo overview, or jump straight to local development to get an app running.