| name | update-dependencies |
| description | Update all dependencies to latest minor versions across the Mantine monorepo, validate, test, build, and generate a report. Use when the user wants to update dependencies, upgrade packages, run dependency maintenance, or asks to "update deps", "upgrade dependencies", "dependency update", "/update-dependencies". |
Update Dependencies
Update all dependencies to their latest minor versions, validate everything works, and produce a report.
Steps
1. Update minor versions
Run npx npm-check-updates to update all package.json files to latest minor versions:
npx npm-check-updates --target minor -u --deep
2. Sync and install
npm run syncpack:fix
npm run syncpack:format
yarn install
If npm run syncpack (list-mismatches) still reports errors after fix, resolve them manually.
3. Run tests
npm run test:all
This runs oxfmt, syncpack, typecheck, lint, and jest.
If there are formatting/lint errors, fix them:
npm run format:write
npx eslint --fix packages apps/mantine.dev/src apps/help.mantine.dev/src scripts --cache
If there are type errors caused by updated packages (e.g., recharts changing generic type parameters), fix them with minimal changes — use type assertions or add missing type arguments. These are minor fixable errors.
Re-run npm run test:all to confirm fixes. If there are major errors that require significant refactoring, document them in the report but do not attempt large refactors.
4. Build packages
npm run build all
Verify no build errors. If there are errors, document them in the report.
5. Storybook
npm run storybook
Wait for Storybook to start (watch for "Storybook X.X started" or the local URL in output). Verify it starts without crash. Kill the process after confirming. Document any errors in the report.
6. Docs build
npm run docs:build
Verify it completes without errors. Document any errors in the report.
7. Check available major updates
Run ncu without -u to list available major updates (for the report only, do not install):
npx npm-check-updates --deep
Filter the output to show only major version bumps (where the major version number changed).
8. Generate report
Create claude/{YYYY-month-DD}-dependencies-update.md where month is lowercase full name (e.g., 2026-march-08-dependencies-update.md).
Report format:
# Dependencies Update — YYYY-MM-DD
## Updated packages (minor)
| Package | From | To |
|---------|------|----|
| package-name | 1.2.3 | 1.3.0 |
| ... | ... | ... |
## Validation results
- **syncpack**: PASS/FAIL (details if fail)
- **test:all**: PASS/FAIL (details if fail)
- **build**: PASS/FAIL (details if fail)
- **storybook**: PASS/FAIL (details if fail)
- **docs:build**: PASS/FAIL (details if fail)
## Errors encountered
(List any errors that were fixed or remain unresolved)
## Available major updates (not installed)
| Package | Current | Latest | Notes |
|---------|---------|--------|-------|
| package-name | 1.x | 2.x | |
| ... | ... | ... | |
9. Commit
If all validations pass (or only minor fixable issues were resolved), create a commit:
[core] Update minor dependencies version
Stage all changed package.json files, yarn.lock, and any files modified to fix minor errors.
If there are unresolved major errors, do NOT commit — only generate the report.
