📄️ How to set up local development
Complete zero-to-running development environment setup with interactive verification
📄️ How to run the backend
Start the Kotlin backend locally with Gradle, configure database access, and verify the health endpoint
📄️ How to run the frontend
Start the Next.js console for local development with API proxy configuration
📄️ How to run tests
Run unit, integration, and e2e tests across all platforms with coverage and debugging tips
📄️ How to add an API endpoint
End-to-end guide from Protobuf schema to Kotlin handler to TypeScript client
📄️ How to add a proto schema
Add or modify Protobuf schemas and regenerate code for all platforms
📄️ How to create a database migration
Write and run Flyway migrations for product and internal databases
📄️ How to deploy to dev
Build Docker images, push to ACR, and deploy to the AKS dev namespace
📄️ How to deploy to staging
CI/CD pipeline flow for staging deployments
📄️ How to debug AKS pods
Troubleshoot running pods with kubectl logs, exec, and port-forward
📄️ How to update Helm charts
Modify Helm values, dry-run changes, and rollback deployments
📄️ How to update Terraform
Per-tier guidance for infrastructure changes with safety callouts
📄️ How to create an agent task
Create tasks in Plane and dispatch them to AI agents via Astra
📄️ Troubleshooting
Common errors and solutions across all platforms