calculus-guy/AreaFadaOs

**AreaFada OS** is an all-in-one creator management platform built for African artists, influencers, and entertainment brands. It combines social scheduling, monetization, fan engagement, live video, ambassador CRM, and AI-powered campaign intelligence into a single workspace. # AreaFada OS — Backend **AreaFada OS** is an all-in-one creator management platform built for African artists, influencers, and entertainment brands. It combines social scheduling, monetization, fan engagement, live video, ambassador CRM, and AI-powered campaign intelligence into a single workspace. This repo is the **backend API only**. The web frontend is a separate repo, deployed independently to Vercel. --- ## Repo Layout ``` / ├── backend/ # Express 5 REST API (Node.js backend), deployed to Render ├── packages/ │ ├── db/ # Drizzle ORM schema, migrations, seed scripts │ ├── api-spec/ # OpenAPI spec (source of truth for all routes) │ └── api-zod/ # Orval-generated Zod request/response schemas ├── render.yaml # Render Blueprint (build/start commands + env var list) ├── pnpm-workspace.yaml # pnpm workspace + catalog versions └── tsconfig.base.json # Shared TypeScript compiler options ``` `packages/db` and `packages/api-zod` are workspace dependencies of `backend/` (via `workspace:*`) — that's why they live alongside it rather than inside it. `packages/api-spec` is kept because it's the codegen source for `api-zod`; regenerate with `pnpm --filter @workspace/api-spec run codegen` after changing any route shape. --- ## Prerequisites | Tool | Version | |------|---------| | Node.js | 24+ | | pnpm | 10+ | | PostgreSQL | 15+ (or a hosted provider — Neon, Supabase, Render Postgres, etc.) | --- ## Local Setup ```bash # 1. Clone the repo git clone github.com cd AreaFadaOs # 2. Install dependencies pnpm install # 3. Configure environment variables cp backend/.env.example backend/.env # Edit backend/.env — fill in DATABASE_URL, Clerk keys, and any other required values # 4. Apply the database schema pnpm --filter @workspace/db run migrate # 5. Start the API server pnpm --filter @workspace/api-server run dev ``` The API server listens on t …