Skip to main content

Dependency Management

Managing dependencies in the Gauzy monorepo.

Package Manager​

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

# 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​

Dependencies are defined at:

Levelpackage.json LocationPurpose
Root./package.jsonDev tools, shared deps
Appsapps/*/package.jsonApp-specific deps
Packagespackages/*/package.jsonLibrary deps

Common Issues​

Hoisting Conflicts​

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

# Force clean install
rm -rf node_modules
yarn install

Peer Dependency Warnings​

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

Dependency Audit​

# Check for vulnerabilities
yarn audit

# Check for outdated packages
yarn outdated

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

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​

For private packages, configure Verdaccio:

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

See Private Registry Configuration for details.