Skip to main content

Outdated `@trackunit/*` dependency warning now points to the migrations generator

If your Iris App build warned you about outdated @trackunit/* dependencies, it used to tell you to reach for npm-check-updates — a command that never actually applied our migrations, leaving you on a path that didn't work. That warning now points at the right tool.

What changed​

The outdated-dependency check in @trackunit/iris-app-build-utilities (v2.4.25) now recommends the @trackunit/migrations generator instead of npm-check-updates:

npm i -D @trackunit/migrations   # only needed once
npx nx g @trackunit/migrations:migrate
npx nx g @trackunit/migrations:run-migrations

migrate updates every @trackunit/* dependency in your package.json and installs them; run-migrations then applies any code migrations those new versions ship.

Workspaces scaffolded with @trackunit/iris-app v2.5.26 or later come with @trackunit/migrations already added as a devDependency and an update:trackunit script wired to this flow, so the command in the warning works immediately. If your workspace predates this, add the package once as shown above — an update:trackunit script you already have (for example one calling npm-check-updates from CI) is left as-is, so nothing breaks under you.

See Maintaining Your Application for the full upgrade guide.