🦄 Features

• Build for Any Browser: Export to Chrome, Firefox, Edge, and Opera.
• NPM & Gulp: Fueled by an intuitive incorporation of npm and gulp.

🚀 Getting started

1. Create a repo from the Ultimate Browser Extension template.
2. Clone the repo to your local machine.
3. Run these command to get everything setup and sync'd!

npm install
npx bxm setup
npm start

4. Open your browser and navigate to chrome://extensions (or the equivalent for your browser).
5. Enable Developer mode.
6. Click on Load unpacked and select the dist folder in your project directory.
7. Your extension should now be loaded and ready to use!

📦 How to sync with the template

1. Simply run npx bxm setup in Terminal to get all the latest updates from the Ultimate Browser Extension template.

🌐 Automatic Translation

When you run npm run build, BEM automatically translates your src/_locales/en/messages.json to 16 languages using Claude CLI: zh, es, hi, ar, pt, ru, ja, de, fr, ko, ur, id, bn, tl, vi, it

Only missing translations are generated - existing translations are preserved.

🌎 Publishing your extension

Manual Upload

1. Run npm run build in Terminal to build your extension for production.
2. Upload the .zip file to the browser's extension store.

Automatic Publishing

BEM can automatically publish to Chrome, Firefox, and Edge stores when BXM_IS_PUBLISH=true:

BXM_IS_PUBLISH=true npm run build

Setup: Add store credentials to your .env file:

# Chrome Web Store
CHROME_EXTENSION_ID="your-extension-id"
CHROME_CLIENT_ID="your-client-id"
CHROME_CLIENT_SECRET="your-client-secret"
CHROME_REFRESH_TOKEN="your-refresh-token"

# Firefox Add-ons
FIREFOX_EXTENSION_ID="your-extension-id"
FIREFOX_API_KEY="your-api-key"
FIREFOX_API_SECRET="your-api-secret"

# Microsoft Edge Add-ons
EDGE_PRODUCT_ID="your-product-id"
EDGE_CLIENT_ID="your-client-id"
EDGE_API_KEY="your-api-key"

Only stores with configured credentials will be published to.