🔌 Loading the Unpacked Extension in Chrome
To test the extension locally in Google Chrome or any Chromium-based browser (Brave, Edge, Arc):
Step-by-Step Instructions
-
Build the extension:
make buildEnsure the
dist/directory exists and containsmanifest.json,service-worker.js, andcontent/. -
Open Extensions Manager in Chrome:
- Navigate to
chrome://extensionsin your address bar. - Or open the Chrome Menu (
⋮) -> Extensions -> Manage Extensions.
- Navigate to
-
Enable Developer Mode:
- Toggle the Developer mode switch in the top-right corner of
chrome://extensions.
- Toggle the Developer mode switch in the top-right corner of
-
Load Unpacked:
- Click the Load unpacked button in the top-left toolbar.
- Select the
dist/directory inside this repository (/path/to/hckr-tools-browser-extension/dist).
-
Pin and Open:
- Click the Puzzle icon in Chrome's toolbar to find hckr — Dev Toolkit.
- Pin it to the toolbar for 1-click access to the Side Panel.
Reloading Changes
When running make dev, Vite will re-bundle files upon every save. To see changes in Chrome:
- For Side Panel React code: Simply close and reopen the side panel, or right-click within the panel and click Inspect -> Reload.
- For Service Worker or Content Scripts: Click the Reload (↺) icon on the extension card in
chrome://extensions.