Deployment
How Ethica ships changes across develop and production. For where each layer runs (Netlify, DigitalOcean, SaaS), see Architecture — Deployment.
Environments
| Environment | Purpose |
|---|---|
| Develop | Integration and pre-production work. |
| Production | Live users. |
Frontends (staff ERP, customer portal, onboarding, admin, documentation): one Netlify site per app per environment—each app has separate Netlify sites for develop and production.
API (ethica-api): deploy to the develop stack first, then production, following the branch flow below.
Branching and CI/CD
- Day-to-day: push to
developfor the API and all frontends. - Production: merge into
main(including via PR merge). CI/CD deploys automatically whenmainis updated—no manual deploy step is required beyond merging.
Deploy order
- API first — deploy the NestJS API before any frontend that depends on it.
- Database — the API uses automatic schema sync (
dbSyncwithalter: true). There are no hand-written migration runs in this workflow: the application applies schema changes on startup. Coordinate API releases accordingly when schema changes are involved. - Frontends — after the API deployment for that environment is complete, deploy the Netlify sites.
Approval
- Today: verbal approval before merging to
main(small team). - Future: if the team grows, adopt ticket-based approval before production merges—update this page when that policy is in place.
Verification
Post-deploy checks (smoke tests, synthetic monitors) are not standardized yet. Add a short checklist here when you define them.
Related
- Architecture — Deployment — hosting layout and operations context.
- Rollback — if you need to revert a release.