# Dependency Management {#dependency-management}


Managing dependencies in the Gauzy monorepo.


## Package Manager {#package-manager}


Gauzy uses **Yarn Classic (1.x)** for dependency management:

```bash
# Install all dependencies
yarn install

# Add a dependency to root
yarn add package-name

# Add to a specific workspace
yarn workspace @gauzy/api add package-name
```


## Workspace Structure {#workspace-structure}


Dependencies are defined at:

| Level    | `package.json` Location   | Purpose                |
| -------- | ------------------------- | ---------------------- |
| Root     | `./package.json`          | Dev tools, shared deps |
| Apps     | `apps/*/package.json`     | App-specific deps      |
| Packages | `packages/*/package.json` | Library deps           |


## Common Issues {#common-issues}



### Hoisting Conflicts {#hoisting-conflicts}


```bash
# If you get version conflicts
yarn install --check-files

# Force clean install
rm -rf node_modules
yarn install
```


### Peer Dependency Warnings {#peer-dependency-warnings}


```bash
# Ignore peer dependency warnings for known issues
yarn install --ignore-optional
```


## Dependency Audit {#dependency-audit}


```bash
# Check for vulnerabilities
yarn audit

# Check for outdated packages
yarn outdated

# Update a specific package
yarn upgrade package-name@latest
```


## Lockfile Management {#lockfile-management}


- **Always commit `yarn.lock`** — ensures reproducible builds
- **Never manually edit `yarn.lock`** — use yarn commands
- **Resolve merge conflicts** — use `yarn install --force`


## Private Registry {#private-registry}


For private packages, configure Verdaccio:

```bash
# .npmrc
@ever-co:registry=https://packages.ever.co/
//packages.ever.co/:_authToken=${VERDACCIO_TOKEN}
```

See [Private Registry Configuration](https://sourcey-gauzy.pages.dev/devops/private-registry/index.md) for details.


## Related Pages {#related-pages}


- [Monorepo Guide](https://sourcey-gauzy.pages.dev/reference/monorepo-guide/index.md) — workspace layout
- [Development Guide](https://sourcey-gauzy.pages.dev/development/development-guide/index.md) — setup
- [CI/CD Pipeline](https://sourcey-gauzy.pages.dev/deployment/ci-cd/cicd-pipeline-guide/index.md) — CI