Introduction
What Addonova is and the model it uses for browser extensions.
#Addonova is a build framework for browser extensions. It turns a small project tree into complete, browser-specific extension output for Chrome, Chromium, Edge, and Firefox.
A typical project has entrypoints, a manifest, public assets, and optionally modules and hooks:
my-extension/
├── addonova.config.ts
├── package.json
├── public/
│ └── icons/
└── src/
└── entrypoints/
├── background.ts
├── content.ts
├── popup.html
└── popup.ts
npx addonova dev
npx addonova build --browser chrome --browser firefox
npx addonova pack
What Addonova handles
#- Entrypoint discovery from file names and HTML meta tags.
- Manifest synthesis, deep merging, and per-target overrides.
- MV2/MV3 conversion and validation for each browser target.
- JavaScript, TypeScript, HTML, CSS, and asset bundling through Guchho.
- Localized manifests from
_localessources. - Browser launching, watch mode, and extension auto-reload.
- ZIP, TAR, and TAR.GZ packaging, including Firefox source archives.
- Build diagnosis with
doctorandanalyze.
What Addonova does not do
#- It does not publish to extension stores.
- It does not replace the extension runtime. Runtime helpers live in the
separate
@addonova/browserpackage. - It does not sandbox hooks or modules.
The shape of a build
#- Discover and resolve configuration.
- Collect entrypoints from conventions and explicit config.
- Run modules and resolve entrypoint hooks.
- Build assets with Guchho for each browser target.
- Generate and validate the manifest.
- Copy public files and generated assets.
- Report output or package the result.
Continue with Getting started.