Manual install

Install the extension manually on Chromium-based browsers.

This path is mainly for local testing, self-hosted distribution, and pre-store releases. It uses the browser’s developer-mode unpacked extension flow.

01

Download or unpack the extension

Use the release ZIP or build output and make sure you have the unpacked extension folder available on disk.

02

Open the extensions page

In Chrome, Brave, Edge, or another Chromium browser, open chrome://extensions.

03

Enable Developer mode

Turn on Developer mode so the browser shows manual extension loading controls.

04

Load the unpacked folder

Choose Load unpacked and select the extracted extension directory, not just the ZIP file itself.

Recommended

Use the built extension folder

If you build from this repo, the cleanest folder to load is dist/extension/.

Release artifact

ZIP is for download, not direct install

Browsers usually do not install the ZIP directly from a website. Extract it first, then load the folder manually.

Store later

Store install will be simpler

Once the store listing is live, users should prefer that route because it is trusted and updates cleanly.