Architecture Overview

The platform follows a monorepo architecture with Next.js App Router for the frontend, a separate API service layer, and PostgreSQL for persistence. The frontend uses React Server Components by default, with client components only where interactivity is needed.

State management uses a combination of server state (React Query) and local state (Zustand). Real-time updates flow through WebSocket connections managed by a dedicated pub/sub service backed by Redis.

The deployment pipeline uses GitHub Actions for CI/CD, with staging deployments on every PR merge and production releases triggered by Git tags. Infrastructure is managed with Terraform and runs on AWS ECS.