Developer Documentation

Everything you need to build on, extend, and contribute to the Freedom Platform. From local setup to production deployment.

System design, stack overview, and data flow

Local setup, prerequisites, and first run

Schema, migrations, and Drizzle ORM patterns

tRPC routers, REST endpoints, and authentication

React components, routing, and UI patterns

Inngest functions and event-driven workflows

Vitest unit tests and Playwright E2E

Vercel configuration and environment variables

Auth, encryption, RLS, and API key management

Code style, PR process, and commit conventions

Quick Reference

Stack

Next.js 15 + React 19 + tRPC v11 + Drizzle ORM + Neon PostgreSQL

Auth

Clerk (session + API key authentication)

Background Jobs

Inngest (serverless, event-driven)

UI Framework

shadcn/ui (Radix + Tailwind CSS) + Lucide icons

Deployment

Vercel (US-East, iad1)

Multi-tenancy

parentAccounts → companies → teamMembers with RLS