This project supports building browser extension packages for both Chrome (Manifest V3) and Firefox (Manifest V2).

• Node.js (LTS recommended)
• npm (comes with Node.js)

To verify installation:

node -v
npm -v

From the root directory:

npm install

Note: If there are no dependencies listed in package.json, this step is optional.

To build the extension for both browsers:

npm install
npm run build

This script:

• Copies all files from app/ into the distro/ directory

• Applies the correct manifest version for each browser:

  • Chrome → distro/chrome/manifest.json (uses manifest.base.json and manifest.chrome.json)
  • Firefox → distro/firefox/manifest.json (uses manifest.base.json and manifest.firefox.json)

⚠️ Extensions loaded this way are not auto-updated. You will need to repeat the steps for future versions.

⚠️ Disclaimer: Unpacked Chrome extensions loaded via "Developer Mode" will remain active across browser restarts, but Chrome may display a warning banner each time. These extensions are intended for development and testing purposes only.

In Firefox, temporary add-ons loaded through about:debugging will be deactivated when the browser is closed. To persist an extension in Firefox, it must be signed and installed as a .xpi file which is not yet available.

Chrome:

1. Navigate to chrome://extensions
2. Enable Developer mode
3. Click Load unpacked
4. Select the distro/chrome/ folder

Firefox:

1. Navigate to about:debugging
2. Click This Firefox
3. Click Load Temporary Add-on
4. Select the distro/firefox/manifest.json file

You can also download prebuilt versions from the latest GitHub Release. Look for files named:

• <repo>-chrome.<version>.zip
• <repo>-firefox.<version>.zip

Steps:

1. Download and extract the .zip file for your browser.
2. Follow the same steps as Option 1, but select the extracted folder instead of distro/.