Home Original page

GitHub - iAverages/npmx-redirect: Browser extension that automatically redirects npmjs.com URLs to npmx.dev.

npmx-redirect

Browser extension that automatically redirects npmjs.com URLs to npmx.dev.

Installation

Install from Webstores

Download from GitHub Releases

  1. Visit the GitHub Releases page
  2. Download the appropriate ZIP file for your browser:
    • Chrome: npmx-redirect-chrome-mv3.zip
    • Firefox: npmx-redirect-firefox-mv3.zip (or npmx-redirect-firefox-mv2.zip for older versions)
    • Edge: npmx-redirect-edge-mv3.zip
    • Brave: npmx-redirect-brave-mv3.zip
    • Opera: npmx-redirect-opera-mv3.zip
  3. Extract the ZIP file to a folder on your computer

Install in Chrome

  1. Open Chrome and navigate to chrome://extensions/
  2. Enable "Developer mode" using the toggle in the top right
  3. Click "Load unpacked"
  4. Select the extracted extension folder (e.g., chrome-mv3-prod)
  5. The extension is now installed and active

Install in Firefox

  1. Open Firefox and navigate to about:debugging#/runtime/this-firefox
  2. Click "Load Temporary Add-on"
  3. Navigate to the extracted extension folder and select the manifest.json file
  4. The extension is now installed and active

Note: Firefox requires re-loading temporary extensions after each browser restart.

Usage

Once installed, the extension automatically redirects all npmjs.com URLs to their npmx.dev equivalents:

  • https://www.npmjs.com/package/react redirects to https://npmx.dev/package/react
  • https://www.npmjs.com/~username redirects to https://npmx.dev/~username
  • https://www.npmjs.com/org/example redirects to https://npmx.dev/org/example
  • Search queries are also redirected

No configuration required.

Development

Prerequisites

  • Node.js 20+
  • pnpm

Setup

# Install dependencies
pnpm install

# Run development server
pnpm dev

Load the development build from build/chrome-mv3-dev (or your target browser) in your browser.

Build

# Build for all browsers
pnpm build:all

# Build for specific browser
pnpm build:chrome
pnpm build:firefox
pnpm build:edge

Production builds are output to the build/ directory.

Testing

# Run tests
pnpm test

# Run tests with UI
pnpm test:ui

Contributing

Contributions are welcome.

License

MIT