Plug-and-play, zero-config, cross-browser extension development tool.
![Screenshot 2024-03-25 at 13 06 15](https://private-user-images.githubusercontent.com/4672033/316628309-01a90694-4705-416e-898c-20bf845984e7.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM5MDI4ODUsIm5iZiI6MTcyMzkwMjU4NSwicGF0aCI6Ii80NjcyMDMzLzMxNjYyODMwOS0wMWE5MDY5NC00NzA1LTQxNmUtODk4Yy0yMGJmODQ1OTg0ZTcucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDgxNyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA4MTdUMTM0OTQ1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MjllMzE0ZmM0YWRjYjg1NzRmOWViMWY4MDAyNzBlM2ZmNDgyMDgxZGM4YzUxZmVkNWM4MzdjZmViMGQzZjg2YSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.0tGaljwKpNm3up0_C_HiYrSYALoB3_koPJrLxU8WbG0)
Create cross-browser extensions with no build configuration.
- Create A New Extension โ How to create a new extension.
- Get Started Immediately โ Get work done in no time.
- I have An Extension - Use only specific parts of
Extension.js
.
Extension.js
is a plug-and-play, zero-config, cross-browser extension development tool with built-in support for TypeScript, WebAssembly, React, and modern JavaScript.
npx extension create my-extension
cd my-extension
npm run dev
A new browser instance will open up with your extension ready for development.
You are done. Time to hack on your extension!
create-a-new-extension.mp4
Dive right into development by starting with a sample from the Chrome Extension Samples repository. It's a great way to get acquainted with best practices and save time:
- Open your terminal.
- Navigate to the directory where you want your project.
- Run the command:
Replace
npx extension dev <sample-name>
<sample-name>
with the name of the sample you wish to use from Chrome Extension Samples.
See the example below where we request the sample page-redder from Google Chrome Extension Samples.
npx extension dev https://github.com/GoogleChrome/chrome-extensions-samples/tree/main/functional-samples/sample.page-redder --browser=edge
chrome-extension-sample-page-redder-on-edge.mp4
Use Microsoft Edge
to kickstart any sample from chrome-extesions-sample
Extension.js
supports a variety of browsers, including Microsoft Edge. To start an Edge-compatible extension, simply:
- Open your terminal.
- Navigate to your desired project directory.
- Execute:
Tailor your command by replacing
npx extension dev <sample-name> --browser=edge
<sample-name>
with the specific sample you're interested in.
See the example below where we request the sample magic8ball from from Google Chrome Extension Samples using Edge as the runtime browser.
npx extension dev https://github.com/GoogleChrome/chrome-extensions-samples/tree/main/api-samples/topSites/magic8ball --browser=edge
chrome-extension-sample-magic8ball-on-edge.mp4
Bridge the gap between Firefox and Edge by running Mozilla Add-Ons using Edge:
- Navigate to your project directory.
- Use the command:
This will fetch a Mozilla Add-On and adapt it for Edge.
npx extension dev <addon-name> --browser=edge --polyfill=true
See the example below where we request the sample Apply CSS from MDN WebExtensions Examples using Edge as the runtime browser.
npx extension dev https://github.com/mdn/webextensions-examples/tree/main/apply-css --browser=edge --polyfill=true
mdn-webextensions-examples-apply-css-on-edge.mp4
usage-with-an-existing-extension.mp4
If you have an existing extension which is using a package manager, you can install the Extension.js
package and manually create the scripts used to run your extension. See the demo above or follow these instructions to get it done:
Step 1 - Install extension as a devDependency
npm install extension --save-dev
Step 2 - Link your npm scripts with the executable Extension.js
commands
{
"scripts": {
"build": "extension build",
"dev": "extension dev",
"start": "extension start"
},
"devDependencies": {
// ...other deps,s
"extension": "latest"
}
}
Done. You are all set!
- To develop the extension, run
npm run dev
. - To visualize the extension in production mode, run
npm run start
. - To build the extension in production mode, run
npm run build
.
โ๏ธ = Likely works but no browser runner support yet.
Brave Browser | Google Chrome | Microsoft Edge | Mozilla Firefox | Opera Browser | Apple Safari | Vivaldi Browser |
โ๏ธ | โ | โ | โ๏ธ | โ๏ธ | โ๏ธ | โ๏ธ |
Firefox For Android | Safari On iOS |
โ๏ธ | โ๏ธ |
If you want to target a specific browser, just pass the --browser
flag to the dev
/start
command (based on the list available above), like npx extension dev path/to/extension --browser=edge
.
Hint Pass --browser="all" to load all available browsers at once.
extension dev --browser=all
![Screenshot 2024-03-25 at 13 06 15](https://private-user-images.githubusercontent.com/4672033/316628309-01a90694-4705-416e-898c-20bf845984e7.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjM5MDI4ODUsIm5iZiI6MTcyMzkwMjU4NSwicGF0aCI6Ii80NjcyMDMzLzMxNjYyODMwOS0wMWE5MDY5NC00NzA1LTQxNmUtODk4Yy0yMGJmODQ1OTg0ZTcucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDgxNyUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA4MTdUMTM0OTQ1WiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MjllMzE0ZmM0YWRjYjg1NzRmOWViMWY4MDAyNzBlM2ZmNDgyMDgxZGM4YzUxZmVkNWM4MzdjZmViMGQzZjg2YSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.0tGaljwKpNm3up0_C_HiYrSYALoB3_koPJrLxU8WbG0)
MIT (c) Cezar Augusto.