Local development

This guide focuses on common workflows for working in this monorepo.

Running services

Most APIs are FastAPI apps and run on port 8080 by default.

uv run --package handler main.py

For hot reload during development:

uv run --package handler uvicorn main:app --reload --port 8080

Environment files

• Each service reads a local .env file in its own directory.
• Do not commit secrets. Use Secret Manager in production.

Common commands

# Run all tests
uv run pytest

# Run service-specific tests
uv run pytest services/handler

# Format and lint
uv run ruff format
uv run ruff check

Protobuf stubs

When editing .proto files under proto/:

buf generate

Frontend apps

• Docs: cd docs && bun run dev
• Nest web: pnpm --dir apps/nest dev
• Raven desktop: cd apps/raven && flutter run -d macos