# CI/CD Overview {#cicd-overview}


Ever Gauzy uses multiple CI/CD pipelines for building, testing, and deploying across all platforms.


## CI/CD Platforms {#cicd-platforms}


| Platform           | Purpose                               |
| ------------------ | ------------------------------------- |
| **GitHub Actions** | Desktop apps, releases, Docker images |
| **CircleCI**       | API and webapp builds, testing        |


## Pipeline Architecture {#pipeline-architecture}


```
Code Push / PR
     │
     ├── GitHub Actions
     │   ├── Build Desktop Apps (Win, Mac, Linux)
     │   ├── Build Docker Images
     │   ├── Publish to GitHub Releases
     │   └── Push to Container Registry
     │
     └── CircleCI
         ├── Lint & Type Check
         ├── Build API & Webapp
         ├── Run Tests
         └── Deploy to Staging/Production
```


## Build Targets {#build-targets}


| Target            | CI Platform    | Output                |
| ----------------- | -------------- | --------------------- |
| API (NestJS)      | CircleCI       | Docker image          |
| Webapp (Angular)  | CircleCI       | Docker image / static |
| Desktop Timer     | GitHub Actions | .exe, .dmg, .AppImage |
| Desktop Server    | GitHub Actions | .exe, .dmg, .AppImage |
| Browser Extension | GitHub Actions | .zip                  |


## NX Integration {#nx-integration}


All builds use NX for task orchestration:

```bash
# Build only affected projects
npx nx affected --target=build

# Build specific project
npx nx build api

# Build with remote caching
npx nx build api --skip-nx-cache=false
```


### NX Cloud {#nx-cloud}


Remote caching accelerates CI builds:

```bash
# Enable NX Cloud
NX_NO_CLOUD=false
NX_CLOUD_ACCESS_TOKEN=your-token
```


## Related Pages {#related-pages}


- [GitHub Actions](https://sourcey-gauzy.pages.dev/deployment/ci-cd/github-actions/index.md) — desktop and release workflows
- [CircleCI](https://sourcey-gauzy.pages.dev/deployment/ci-cd/circleci/index.md) — API and webapp pipelines
- [Self-Hosted Runners (Windows)](https://sourcey-gauzy.pages.dev/deployment/ci-cd/self-hosted-runners-windows/index.md) — provisioning Windows build machines