Onboarding
First-week documentation for new engineers joining the Qubital team. This section gives you enough context to understand the system, set up your local environment, and make your first contribution without needing to ask teammates for context at every step.
What you'll find here
- Local environment setup — getting the backend, frontend, and required services running on your machine
- System orientation — how the pieces fit together (backend, frontend, Cloudflare Workers, external services)
- Development workflow — branching model, PR process, CI checks, and how to deploy
- Access and credentials — what you need access to and how to get it
Before you start
Read these first — they give the mental model everything else builds on:
../architecture/index.md— high-level system overview and component map../reference/backend/index.md— backend codebase layout and the two binaries../reference/platform/services/index.md— external services the system depends on../reference/backend/configuration.md— environment variables you will need locally
Stack at a glance
| Layer | Technology |
|---|---|
| Backend | Go, Gin, PostgreSQL (Supabase), deployed on Sevalla |
| Frontend | Electron, React, TypeScript |
| Real-time | LiveKit Cloud (audio/video), Cloudflare office-router Worker (WebSocket) |
| Auth | WorkOS (AuthKit, SSO, org management) |
| Storage | Cloudflare R2 (avatars, recording temp storage) |
| Observability | Betterstack (logs), Grafana Cloud / Mimir (metrics) |
| CI/CD | GitHub Actions, GHCR, Wrangler (Cloudflare), Google Cloud Run |
Phase 0 note: individual onboarding guides (local setup, workflow walkthrough, access checklist) to be written during baseline generation.