Scaffold a project

Create an extension with addonova init and make the first build.

#

Create

#
npx addonova init my-extension
cd my-extension
npm install

Pick another template or package manager:

npx addonova init my-extension --template react --pm pnpm
npx addonova init my-extension --template vanilla-js --pm bun

Templates: vanilla-ts, vanilla-js, react.

Inspect

#
my-extension/
├── addonova.config.ts
├── package.json
├── public/
│   └── icons/icon-128.png
└── src/
    ├── entrypoints/
    │   ├── background.ts
    │   ├── content.ts
    │   └── popup/
    │       ├── index.html
    │       ├── popup.ts
    │       └── style.css
    └── _locales/en/messages.json

Bundled templates set:

export default defineConfig({
  browsers: ['chrome'],
  browserApi: 'bundle',
  manifest: {
    name: 'My Extension',
    version: '1.0.0',
  },
});

Build

#
npm run build
# or
npx addonova build --browser chrome

Output:

dist/chrome/
├── manifest.json
├── background.js
├── content.js
├── popup.html
├── popup.js
├── popup.css
└── icons/icon-128.png

Load unpacked

#
  • Chrome: open chrome://extensions, enable Developer mode, choose Load unpacked, select dist/chrome.
  • Firefox: open about:debugging#/runtime/this-firefox, choose Load Temporary Add-on, select dist/firefox/manifest.json.

Develop

#
npm run dev -- --browser chrome

Add --browser firefox in a second terminal to run both.

Next

#

Edit this page on GitHub