Deployment
Continuous deployment with GitHub Flow, CI/CD pipelines, and platform options.
This section covers deployment strategies, CI/CD setup, and platform-specific configurations.
GitHub Flow
This project follows GitHub Flow for continuous deployment:
- Create feature branch - Branch from
mainfor new features - Make changes - Develop and test locally
- Open pull request - Create PR when ready for review
- Automated checks - GitHub Actions runs tests, linting, security scans
- Code review - CodeRabbit + human review
- Merge to main - Merge when checks pass and approved
- Automatic deployment - Deploy to staging/production automatically
Benefits:
- ✅ Continuous deployment - Every merge triggers deployment
- ✅ Automated quality gates - Tests, linting, security checks
- ✅ AI-powered reviews - CodeRabbit provides immediate feedback
- ✅ Preview environments - Test changes before merging
CI/CD Pipeline
Automated workflows enforce quality standards:
- CodeRabbit - AI-powered code reviews on every PR
- GitHub Actions - Lint and security on every PR; path-filtered app E2E and package unit tests; mobile EAS builds and PR OTA previews
- Pre-commit hooks - Local quality checks (formatting, secrets detection)
See GitHub Actions for CI workflow configuration. For mobile: Mobile CI/CD.
Deployment Platforms
Vercel (Recommended for Development)
Fast deployment with preview environments for every PR. Great for rapid iteration and frontend apps.
See Vercel Deployment for details.
Google Cloud / AWS (Production)
Enterprise deployment options with zero code changes required. Great for compliance, security, and scale.
See Portability Strategy for migration paths.
Self-Hosted LLM (Data Privacy)
Run local models with Ollama to keep prompts and responses on your infrastructure. Recommended when handling sensitive data or avoiding third-party API providers.
See Self-Hosted LLM for setup instructions and hardware recommendations.
Publishing Packages
Internal packages can be published to npm using the dual-mode export strategy.
See Publishing Packages for details.
Related Documentation
- Security - Security scanning and secret detection
- Testing - Testing strategies and patterns
- Portability Strategy - Zero vendor lock-in