Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Migrate all npm packages to Volta management

Open
#163 1 comment 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
35/100
Issue type
Refactor
Clarity
Mostly clear
Activity status
Stale
Tech stack
javascript, node.js
Domain
devops, tooling

Research direction

Start with hosts/npm-tools/default.json and hosts/base-home.nix, then review the completed package and PATH changes before applying the nix-darwin configuration. Confirm Volta-managed tools work, remove the listed global npm packages, and run npm list -g --depth=0 to verify that no packages remain.

Written by the indexing model from the issue text.

Description

Migrate all npm packages to Volta management

Summary

Currently, the system has npm packages installed globally via npm in /usr/local/lib/node_modules, which creates conflicts and inconsistencies. All npm packages should be managed exclusively through Volta for better version control and user isolation.

Current State

The following npm packages are installed globally outside of Volta:

  • @anthropic-ai/claude-code (1.0.44)
  • @biomejs/biome
  • @commitlint/cli
  • @commitlint/config-conventional
  • @slidev/cli
  • @slidev/theme-bricks
  • @slidev/theme-default
  • astro
  • conventional-changelog-atom
  • corepack
  • crx
  • generator-code
  • grunt-cli
  • npm
  • pnpm
  • stylelint
  • stylelint-config-standard
  • stylelint-config-standard-scss
  • vsce
  • web-ext
  • yo

Migration Plan

  1. ✅ Update npm-tools configuration files to include all packages
  2. ✅ Fix PATH configuration to prioritize Volta-managed tools
  3. ⏳ Apply nix-darwin configuration to install tools via Volta
  4. ⏳ Remove global npm installations from /usr/local/lib/node_modules
  5. ⏳ Verify all tools work correctly through Volta

Configuration Changes Made

  • Updated hosts/npm-tools/default.json to include all npm packages
  • Modified hosts/base-home.nix to set explicit PATH without contamination from other users
  • PATH now prioritizes $HOME/.volta/bin over /usr/local/bin

Cleanup Steps Required

# After Volta installation is confirmed working:
sudo npm uninstall -g @anthropic-ai/claude-code @biomejs/biome @commitlint/cli @commitlint/config-conventional @slidev/cli @slidev/theme-bricks @slidev/theme-default astro conventional-changelog-atom corepack crx generator-code grunt-cli pnpm stylelint stylelint-config-standard stylelint-config-standard-scss vsce web-ext yo

# Verify no packages remain
npm list -g --depth=0

Benefits

  • User-specific tool installations
  • Better version management
  • No sudo required for npm operations
  • Consistent tool versions across projects
  • Cleaner system state
Dominant language
Jupyter Notebook
Stars
1
Forks
0
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from aRustyDev/dotfiles

All issues in aRustyDev/dotfiles

Similar issues

More DevOps issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.