# Monorepo Workspace Guide {#monorepo-workspace-guide}


Navigate and work within the Gauzy NX monorepo.


## Workspace Layout {#workspace-layout}


```
ever-gauzy/
├── apps/
│   ├── gauzy/              ← Angular web app
│   ├── api/                ← NestJS API server
│   ├── desktop/            ← Electron desktop app
│   ├── desktop-timer/      ← Desktop timer variant
│   └── server/             ← Electron server
├── packages/
│   ├── core/               ← Core API library
│   ├── auth/               ← Authentication
│   ├── common/             ← Shared types & utils
│   ├── config/             ← Configuration
│   ├── contracts/          ← TypeScript interfaces
│   └── plugins/            ← Plugin packages
│       ├── integration-ai/
│       ├── integration-github/
│       └── ...
├── libs/
│   ├── ui-core/            ← Angular shared UI
│   └── desktop-libs/       ← Desktop shared libs
├── nx.json
├── workspace.json
└── package.json
```


## Key Commands {#key-commands}


| Command          | Description         |
| ---------------- | ------------------- |
| `yarn start:api` | Start API (dev)     |
| `yarn start`     | Start web app (dev) |
| `yarn build:api` | Build API           |
| `yarn build`     | Build web app       |
| `yarn test`      | Run all tests       |
| `yarn lint`      | Lint all packages   |


## NX Commands {#nx-commands}


```bash
# Run specific project target
npx nx run api:build

# Affected builds (only changed)
npx nx affected:build

# Dependency graph
npx nx graph

# List all projects
npx nx show projects
```


## Package Dependencies {#package-dependencies}






```mermaid
graph TB
    API[apps/api] --> Core[packages/core]
    API --> Auth[packages/auth]
    Core --> Common[packages/common]
    Core --> Config[packages/config]
    Core --> Contracts[packages/contracts]
    Common --> Contracts

    Web[apps/gauzy] --> UICore[libs/ui-core]
    UICore --> Contracts
```






## Related Pages {#related-pages}


- [Development Guide](https://sourcey-gauzy.pages.dev/development/development-guide/index.md) — setup
- [Git Workflow](https://sourcey-gauzy.pages.dev/development/git-workflow/index.md) — branching
- [Dependency Management](https://sourcey-gauzy.pages.dev/reference/dependency-management/index.md) — deps