Ever Teams uses GitHub Actions for continuous integration and continuous deployment, with Docker for containerized builds and deployments.
GitHub Actions Workflows
The project includes 34 GitHub Actions workflows in .github/workflows/:
Web Application
| Workflow | Trigger | Description |
|---|
web.before-merge.yml | PR | Lint, type-check, and build validation |
deploy-vercel-dev.yml | Push to develop | Deploy to Vercel (dev) |
deploy-vercel-stage.yml | Push to stage | Deploy to Vercel (staging) |
deploy-vercel-prod.yml | Push to main | Deploy to Vercel (production) |
deploy-do-dev/stage/prod.yml | Push to branches | Deploy to DigitalOcean |
deploy-render-dev.yml | Push to develop | Deploy to Render |
Docker
| Workflow | Trigger | Description |
|---|
docker-build-publish-dev.yml | Push to develop | Build and push Docker image (dev tag) |
docker-build-publish-stage.yml | Push to stage | Build and push Docker image (stage tag) |
docker-build-publish-prod.yml | Push to main | Build and push Docker image (latest tag) |
Desktop
| Workflow | Trigger | Description |
|---|
desktop.apps.yml | Release/manual | Build desktop app for all platforms |
desktop-server-web.apps.yml | Release/manual | Build server-web Electron app |
desktop-server-api.apps.yml | Release/manual | Build server-api Electron app |
Mobile
| Workflow | Trigger | Description |
|---|
mobile.apps.ios.yml | Release | Build iOS app |
mobile.apps.android.yml | Release | Build Android app |
mobile.apps.stage.ios.yml | Push to stage | Build iOS staging app |
mobile.apps.stage.android.yml | Push to stage | Build Android staging app |
mobile.before-merge.yml | PR | Mobile build validation |
mobile.dev/stage/prod.yml | Environment branches | Mobile CI for environments |
Extensions
| Workflow | Trigger | Description |
|---|
extensions.dev.yml | Push to develop | Build browser extension (dev) |
extensions.prod.yml | Push to main | Build and publish extension |
Releases
| Workflow | Trigger | Description |
|---|
release.dev.yml | Push to develop | Development release |
release.stage.yml | Push to stage | Staging release |
release.prod.yml | Push to main | Production release |
release.apps.yml | Manual/tag | Full app release |
Quality
| Workflow | Trigger | Description |
|---|
typos.yml | PR | Check for typos in code |
knip-cleanup.yml | Manual | Find unused code and dependencies |
Docker Build Pipeline
Dockerfile
The web app Dockerfile is at .deploy/web/Dockerfile:
Docker Compose Configurations
| File | Use Case |
|---|
docker-compose.yml | Full production stack (API + webapp + infra) |
docker-compose.demo.yml | Quick demo with pre-built images |
docker-compose.dev.yml | Development with hot-reload |
docker-compose.build.yml | Build everything from source |
docker-compose.infra.yml | Infrastructure services only |
Container Registry
Images are published to:
- GitHub Container Registry:
ghcr.io/ever-co/
- Docker Hub:
everco/
Release Process
Branching Strategy
| Branch | Purpose | Deploys To |
|---|
main | Production releases | Production |
stage | Staging / QA | Staging |
develop | Active development | Development |
feature/* | Feature branches | PR previews |
Semantic Versioning
Releases follow Semantic Versioning with Conventional Commits:
feat: → minor version bumpfix: → patch version bumpBREAKING CHANGE: → major version bump
Tools: semantic-release, commitizen, commitlint
Environment Management
| Environment | Branch | API | URL |
|---|
| Production | main | api.ever.team | app.ever.team |
| Staging | stage | apistage.gauzy.co | stage.ever.team |
| Development | develop | apidev.ever.team | dev deployment |
CI/CD Infrastructure
Self-Hosted Runners
Ever Teams uses both GitHub-hosted and self-hosted runners:
- GitHub-hosted: Linux (Ubuntu) for web and Docker builds
- Self-hosted: Windows x64 and ARM64 for Electron desktop builds
- macOS: For iOS and macOS desktop builds
Caching
| Cache Type | Provider |
|---|
| NX Cache | NX Cloud |
| Yarn dependencies | actions/cache |
| Docker layers | Docker BuildKit cache |
| Next.js build | .next/cache |