Deployment

Production Deployment

• Build: npm run build
• Deploy app: firebase deploy --only hosting
• Deploy docs: python -m mkdocs gh-deploy --force

Branches

• main: Application code
• gh-pages: Documentation (auto-built by MkDocs)

Firebase Hosting

• Configured via firebase.json
• Uses Vite build output

GitHub Pages

• Docs published from gh-pages branch
• Enable GitHub Pages in repo settings (branch: gh-pages)

CI/CD (Recommended)

• Add GitHub Actions for auto-build/test/deploy
• Lint, test, and build on PRs
• Auto-publish docs on merge to main