Platform Architecture

YourTita modernization reference

Frontend

The Next.js 15 App Router powers marketing, protected dashboard, and isolated demo surfaces. UI primitives live in a reusable @yourtita/ui package and are consumed via feature-oriented modules. React Query manages server state, while lightweight context and route-local client state handle focused flows like the new investor demo.

Backend

FastAPI exposes REST endpoints grouped by domain (auth, caregivers, jobs, media). SQLModel/SQLAlchemy manages persistence against PostgreSQL, with Alembic for migrations. Celery or FastAPI-background tasks will support async workloads such as video processing.

Operations

Docker Compose orchestrates local services (web, api, postgres, mailhog, minio). CI via GitHub Actions runs lint, tests, and builds before deploying the web app to Vercel and the API to Render/Fly.io or containers on AWS.