Unfold by Nimble Links

A browser extension by Nimble Links that reveals where nimble.li short links lead — without clicking on them. Hover over any nimble.li link to see its destination, copy the URL, or open it in a new tab.

Build instructions

Environment requirements

• OS: Any (tested on macOS and Ubuntu 24.04 LTS)
• Node.js: v18 or later (download)
• npm: v9 or later (included with Node.js)

Exact versions used in development: Node v24.13.0, npm 11.6.2. A package-lock.json is included to ensure reproducible dependency installation.

Steps to build from source

1. Install dependencies:

   npm install

2. Build the extension:

   npm run build

   The built extension files are output to dist/.

3. Or, to produce browser-specific zip packages:

   npm run package

   This runs the build and creates zip files in dist/packages/:

   • unfold-chrome-v{version}.zip — for Chrome, Edge, and other Chromium browsers
   • unfold-firefox-v{version}.zip — for Firefox (includes browser_specific_settings)
   • unfold-source-v{version}.zip — source code archive for store review

Development

Start the Vite dev server with hot reload for Chrome:

npm run dev

Then load the dist/ directory as an unpacked extension in chrome://extensions (with Developer Mode enabled).

Project structure

src/
  content.ts    Entry point — injected as a content script on all pages
  content.css   Tooltip and UI styles
  observer.ts   MutationObserver for dynamically added links
  tooltip.ts    Tooltip creation, fetching, and interaction logic
scripts/
  package.js    Multi-browser build and packaging script
manifest.json   Extension manifest (Manifest V3)

License

MIT