Developer Guide

Learn how to build and run the application locally.

Get started

• Install
  • Prerequisites
• Add environment variables
• Google Secret Manager
  • How it works
  • Managing Secrets
• Setup the Database
  • Cloud Run Database Initialization
  • Local Database Initialization
• Triggering Data Imports
  • Using curl
  • Using gcloud
  • Configuration Parameters
• Database Troubleshooting
  • Troubleshooting SQL Queries
  • Shell Configuration
• HTTP 500 Internal Server Error - Troubleshooting
  • Common Causes
  • Diagnostic Steps
  • Recovery

Run the application

• Run the application
  • FastAPI server
  • React frontend
• Python Beginner’s Guide - FastAPI Backend Setup
  • What is Python & FastAPI?
  • Prerequisites
  • Setting Up Your Development Environment
  • Understanding the Project Structure
  • Working with the Census Data API
  • Step-by-Step Tutorial
  • Common Python Concepts
  • Debugging and Troubleshooting
  • Next Steps
  • Helpful Commands Reference
• FastAPI Project - Development
  • Docker Compose
  • Mailcatcher
  • Local Development
  • Docker Compose in localhost.tiangolo.com
  • Docker Compose files and env vars
  • The .env file
  • Pre-commits and code linting
  • URLs
• Testing
  • Prerequisites
  • Running Tests
  • Test Pre-start

Deploy on Google Cloud

• Google Cloud Run Deployment Guide
  • Prerequisites
  • Which Script Should I Run?
  • Recommended Workflow
  • deploy_cloud_run.py Usage
  • Deployment Modes
  • Database Initialization
  • Secrets Management
  • URLs and Access

Security and Maintenance

• Security Emergency Procedures
  • Forced Password Reset Strategy
  • Security Emergency Actions

Documentation

• Sphinx
• Storybook
• Frontend Components
  • Source of truth
  • Component stack
  • shadcn/ui configuration
  • Component directory structure
  • Recommended usage
  • Adding a new component
  • Related documentation
• README Extended Reference
  • Documentation workflows
  • Documentation troubleshooting
  • Frontend client generation
  • Frontend remote API configuration
  • Frontend Playwright tests
  • Backend operations
  • Database migrations
  • Related Developer Guide pages
• Test repository sync
  • Frontend
  • Backend
• WARP.md
  • Architecture
  • Common Commands