> ## Documentation Index
> Fetch the complete documentation index at: https://extension.js.org/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Extension.js needs Node.js 22.12 or newer; Node.js 18 and 20 do not work. It also runs on Deno 2.5+ and Bun 1.2+.
> The default browser target is chromium and a build lands in dist/<browser>, so dist/chromium by default. extension build writes a zip only when --zip is passed.
> Prefix a manifest key with a browser name when browsers differ. chromium: covers every Chromium-family target and Safari builds read it too. Since 4.1.19 chrome: means Chrome alone and edge: means Edge alone.
> Write one background.service_worker in manifest.json instead of hand-writing per-browser background keys; Extension.js converts it for each browser.
> package.json or deno.json marks the project root, not manifest.json. A config file is optional, and only extension.config.js, .mjs and .cjs are loaded, never .ts.
> The bundler is Rspack, extended through the config hook in extension.config.js. A project needs no separate bundler config file.
> Use --no-browser to skip the browser launch; --no-runner no longer exists and --no-open still launches the browser. Use --output for machine output; --format and --wait-format are deprecated.

# September 2026: a showcase page, Deno and Bun

> What shipped in Extension.js in September 2026: a showcase page, Deno and Bun runtimes, Zen and Floorp browser targets, and a single-copy content script reload.

**September 2026**

October 9, 2026

September was two things: a page that shows what people ship with Extension.js, and a run of releases that took the CLI from [4.1.18](https://github.com/extension-js/extension.js/releases/tag/v4.1.18) to [4.1.30](https://github.com/extension-js/extension.js/releases/tag/v4.1.30).

## The showcase

[extension.js.org/showcase](https://extension.js.org/showcase.md) is live. Five extensions, all shipped and all in the stores: [Better Lyrics](https://chromewebstore.google.com/detail/effdbpeggelllpfkjppbokhmmiinhlmg), [Star Citizen Box](https://chromewebstore.google.com/detail/gocnjckojmledijgmadmacoikibcggja), [Simple Virtual Keyboard](https://chromewebstore.google.com/detail/cjabmkimbcmhhepelfhjhbhonnapiipj), [Better Trello](https://chromewebstore.google.com/detail/dnhdnenpngcecekbhklemaidbdpibiae), and [Send to PocketBook](https://chromewebstore.google.com/detail/mockojkggpmpjlajehofiljbbbaoppdj).

Every card is a shipped extension with a real store listing, and no card shows a user count, so nothing on the page rots. A weekly job proposes candidates and [a person adds them](https://extension.js.org/showcase.md#add-your-project).

## Two more runtimes

[4.1.20](https://github.com/extension-js/extension.js/releases/tag/v4.1.20) added Deno. [`deno run -A npm:extension@latest`](https://extension.js.org/docs/languages-and-frameworks/deno) runs dev and build, and both are covered by CI.

[4.1.21](https://github.com/extension-js/extension.js/releases/tag/v4.1.21) added Bun. [`bunx --bun extension@latest dev`](https://extension.js.org/docs/languages-and-frameworks/bun) works on Bun 1.2 or newer, and an older Bun gets one line pointing at the Node.js path.

## More browsers by name

[4.1.26](https://github.com/extension-js/extension.js/releases/tag/v4.1.26) added [`--browser=zen`](https://extension.js.org/docs/browsers/running-other-browsers#run-a-fork-by-name) and [`--browser=floorp`](https://extension.js.org/docs/browsers/running-other-browsers#run-a-fork-by-name). They find a stock install on macOS, Windows, and Linux, the same way Waterfox and LibreWolf already did.

[4.1.29](https://github.com/extension-js/extension.js/releases/tag/v4.1.29) fixed a bug there too. `--browser=brave`, `opera`, `vivaldi`, and `yandex` could open the managed Chrome while the terminal named the fork. Each one runs its own app now, and a check launches every browser and reads which app is really running.

## One manifest, sharper

Since [4.1.19](https://github.com/extension-js/extension.js/releases/tag/v4.1.19), `chrome:` and `edge:` mean that one browser, not the whole Chromium family. [`chromium:`](https://extension.js.org/docs/features/browser-specific-fields) is the family. That made a new failure possible, a manifest that scopes every `manifest_version` to a vendor, so 4.1.21 refuses that build and names the fix.

Production Edge builds now drop a top-level `key`, because [Edge Add-ons](https://extension.js.org/docs/publishing/package-for-the-stores.md) rejects any manifest that contains one. That came from the maintainer of [Better Lyrics](https://github.com/better-lyrics/better-lyrics), who was stripping it by hand after every build.

## Reloads

In dev on Chrome and Edge, saving a content script used to leave the old copy running next to the new one. [4.1.25](https://github.com/extension-js/extension.js/releases/tag/v4.1.25) [registers dev content scripts at runtime](https://extension.js.org/docs/implementation-guide/content-scripts.md#development-behavior), so an edit runs exactly one copy, in the open tabs and in every new page. Editing an HTML page now refreshes that page alone.

## One bug worth naming

A fresh install of [4.1.18](https://github.com/extension-js/extension.js/releases/tag/v4.1.18) through [4.1.23](https://github.com/extension-js/extension.js/releases/tag/v4.1.23) could pull a newer [rspack](https://rspack.rs) than the one we test against, and every page with a linked stylesheet threw on load. [4.1.24](https://github.com/extension-js/extension.js/releases/tag/v4.1.24) pins the bundler and adds a build spec that guards the shape. If you are on any of those versions, upgrade.

## Also

[`extension create --template transformers-js`](https://extension.js.org/docs/languages-and-frameworks/webassembly#transformers-js) scaffolds a side panel that classifies text on device, modeled on [Hugging Face's own extension sample](https://github.com/huggingface/transformers.js-examples/tree/main/browser-extension). [`extension build --browser=opera`](https://extension.js.org/docs/commands/build#readable-output-for-opera-add-ons) ships code without minification, which Opera Add-ons asks for in review. Extension.js is now listed on the [Preact integrations page](https://preactjs.com/about/libraries-addons/), [awesome-vue](https://github.com/vuejs/awesome-vue#scaffold), and [awesome-shadcn-ui](https://github.com/birobirobiro/awesome-shadcn-ui#boilerplates--templates).

October is already at [4.1.33](https://github.com/extension-js/extension.js/releases/tag/v4.1.33). One sidebar key builds for every browser, Safari dev runs leave your own Safari alone, and the sidebar starters read the open tab. More on that next time.

Cezar Augusto\\

Creator and Lead Developer, Extension.js


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.