addfox

library0.1.1-beta.15jsnpmunverified

Addfox is a modern build tool and framework specifically designed for developing browser extensions across multiple platforms. It is built on top of Rsbuild, leveraging its performance for fast development cycles, including hot module replacement (HMR) and automatic browser launching for an efficient developer experience. The current stable version is 0.1.1-beta.15, indicating an active development phase with frequent beta releases. Key differentiators include its framework-agnostic support for popular UI libraries like React, Vue, Svelte, and Solid, and its ability to target various Chromium-based browsers (Chrome, Edge, Brave, etc.) as well as Firefox. Addfox simplifies project setup with file-based entry discovery and offers advanced features such as AI-friendly error output, Rstest integration for unit and end-to-end testing, and Rsdoctor for bundle analysis. It also streamlines deployment by automatically generating store-ready zip files. The tool requires Node.js version 20 or higher, ensuring access to modern JavaScript features and performance improvements.

devops

npm install addfox

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · ADDFOX

addfox

devopsjavascriptv0.1.1-beta.15

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

defineConfig

✓ import { defineConfig } from 'addfox';

✗ const defineConfig = require('addfox').defineConfig;

Used in `addfox.config.ts` for type-safe configuration; Addfox is primarily an ESM package.

AddfoxConfig

✓ import type { AddfoxConfig } from 'addfox';

✗ import { AddfoxConfig } from 'addfox';

Imports the TypeScript type definition for Addfox configuration objects. Use `type` for type-only imports to avoid bundle bloat.

AddfoxPlugin

✓ import type { AddfoxPlugin } from 'addfox';

✗ import { AddfoxPlugin } from 'addfox';

Imports the TypeScript type definition for Addfox plugins, typically used when authoring custom build plugins. Use `type` for type-only imports.

Initializes a new Addfox project using `create-addfox-app`, guiding through framework/language selection, installing dependencies, and starting the development server with HMR.

pnpm create addfox-app # Follow prompts (e.g., select React, TypeScript, npm) to configure your extension. # This command scaffolds a new project, installs dependencies, and sets up addfox. cd my-extension-project pnpm dev # This starts the development server, watches for changes, and hot-reloads the extension in the browser.

addfox --version

Debug

Known issues

breakingAddfox is currently in beta (v0.1.1-beta.15). Its API and internal architecture are subject to change without strict adherence to semantic versioning, potentially introducing breaking changes between minor beta releases.

fix

Review changelogs carefully before updating. Pin exact beta versions in production-like environments or use tools like `pnpm up --latest` with caution.

affects: >=0.1.0-beta.0

gotchaAddfox requires Node.js version 20.0.0 or higher. Older Node.js versions will result in runtime errors or installation failures.

fix

Update your Node.js environment to version 20 or newer using a version manager like `nvm` or `volta` (`nvm install 20 && nvm use 20`).

affects: <20.0.0 (Node.js)

gotchaWhen building for specific browsers (e.g., Firefox, Edge), you must explicitly specify the target using the `-b` flag (e.g., `addfox build -b firefox`). Without it, Addfox typically targets Chromium-based browsers by default.

fix

Always include `-b <browser>` (e.g., `-b chrome`, `-b firefox`, `-b edge`) in your `addfox dev` and `addfox build` commands when you need to target a specific browser or variant.

affects: >=0.1.0-beta.0

gotchaManual setup of Addfox in an existing project requires a `addfox.config.ts` (or `.js`, `.mjs`) file in the project root. Missing or misconfigured files can lead to build errors.

fix

Create an `addfox.config.ts` file in your project root. For a basic configuration, use `import { defineConfig } from 'addfox'; export default defineConfig({});` and customize it based on your `app/` directory structure.

affects: >=0.1.0-beta.0

Errors

Common errors & fixes

Error: The 'addfox' command was not found.

The Addfox CLI package is not installed globally or locally, or it's not in your system's PATH.

fix

Install Addfox as a dev dependency (`pnpm add -D addfox`) or run commands via `pnpm addfox dev` or `npx addfox dev`.

Error: Node.js version '18.x.x' is not supported. Addfox requires Node.js >=20.0.0.

Your current Node.js version is older than the minimum required by Addfox.

fix

Update Node.js to version 20 or higher (e.g., `nvm install 20 && nvm use 20`).

Error: Cannot find module 'addfox.config.ts' in project root.

The `addfox.config.ts` file is missing, misspelled, or located in an incorrect directory.

fix

Ensure `addfox.config.ts` (or `.js`, `.mjs`) exists directly in your project's root directory.

Build failed: Manifest V3 validation failed for <path/to/manifest.json>.

There is an error in your `manifest.json` file, violating Chrome's Manifest V3 specifications (e.g., incorrect permissions, missing required fields, invalid host permissions).

fix

Carefully review the specified `manifest.json` file against the official Manifest V3 documentation for syntax and structural errors. The error message often provides clues about the specific violation.

Upgrade

Version history

0.1.1-beta.15latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

38 hits · last 30 days

node

Anthropic

OpenAI (training)

Resources

githubhttps://github.com/addfox/addfox ↗

packagehttps://www.npmjs.com/package/addfox ↗

homepagehttps://addfox.dev ↗