Extension

Install Without Web Store

Build and load the Chrome extension locally as unpacked output.

This guide installs the Crikket extension without the Chrome Web Store.

Prerequisites

Chrome or any Chromium-based browser
web and server running (local or deployed)
Dependencies installed in repo root:

bun install

Configure Extension Env

cp apps/extension/.env.example apps/extension/.env

Default values:

VITE_APP_URL=http://localhost:3001
VITE_SERVER_URL=http://localhost:3000

If your app is deployed, replace those with deployed URLs.

Build Extension Output

bun run --filter extension build

Output path:

apps/extension/.output/chrome-mv3

Load Unpacked in Chrome

Open chrome://extensions
Turn on Developer mode
Click Load unpacked
Select apps/extension/.output/chrome-mv3

Verify

Extension appears in extensions list
Popup opens without errors
Recording/capture actions can reach your configured backend

Update Loop

After extension code changes:

bun run --filter extension build

Then in chrome://extensions, click reload on the Crikket extension.

Troubleshooting

Troubleshooting common issues with Crikket.

On this page

Prerequisites Configure Extension Env Build Extension Output Load Unpacked in Chrome Verify Update Loop