CollabForge

Production-ready FastAPI enterprise boilerplate featuring Clean Architecture, PostgreSQL, Redis, WebSockets, JWT authentication, Celery, Docker, CI/CD, and scalable backend patterns.

Quick Start (local dev)

python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env

# Start Postgres + Redis (requires Docker Desktop)
docker compose -f docker/docker-compose.yml up postgres redis -d

# Run migrations (first time)
alembic upgrade head

# Start API
uvicorn app.main:app --reload

API: http://localhost:8000 · Docs: http://localhost:8000/docs · WebSocket: ws://localhost:8000/ws?token=<JWT>

Docker (full stack)

cp .env.example .env
docker compose -f docker/docker-compose.yml up --build

Service	URL
API	http://localhost:8000
API docs	http://localhost:8000/docs
Metrics	http://localhost:8000/metrics

CI/CD

CI (.github/workflows/ci.yml) runs on every push/PR to main:

• ruff check + ruff format --check
• pytest
• Docker image build (no push)

Release (.github/workflows/release.yml) publishes to GitHub Container Registry on version tags (v*):

git tag v0.1.0 && git push origin v0.1.0

Architecture

Client → FastAPI API
           ├── PostgreSQL
           ├── Redis (cache + pub/sub)
           └── Celery workers