Skip to content

addfox/addfox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

27 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Addfox

Addfox

Browser extension framework built on Rsbuild

GitHub stars npm version npm downloads
Documentation Β· npm Β· Skills Β· English | δΈ­ζ–‡

Architecture

Addfox wraps Rsbuild (Rspack/Rstack) with extension-specific plugins; build output is loaded in Chrome or Firefox.

addfox β†’ Rsbuild β†’ Extension β†’ Browsers


Features

  • πŸ”₯ Fast dev + HMR β€” addfox dev watches files, rebuilds on change, and hot-reloads the extension.
  • πŸ“¦ Zip on build β€” addfox build outputs extension files and a store-ready zip in .addfox.
  • πŸ“ File-based entries β€” Auto-discovers entries from app/ (background/content/popup/options/sidepanel/devtools) with custom entry support.
  • 🌐 Cross-browser targets β€” -b supports Chromium browsers and Firefox with browser-specific manifest overrides.
  • βš›οΈ Framework-agnostic β€” Works with Vue, React, Svelte, Solid, or vanilla (TS/JS).
  • πŸ€– AI-friendly debugging β€” --debug shows per-entry runtime errors in terminal.
  • πŸ§ͺ Built-in testing flow β€” addfox test forwards args to Rstest for unit and e2e workflows.
  • πŸ“Š Rsdoctor reports β€” Add --report in dev/build to generate bundle analysis.
  • 🧩 Skills integration β€” Supports addfox/skills via scaffold or skills add.
  • πŸ” Env control β€” Loads .env and exposes vars via envPrefix rules.

Install & use

New project:

pnpm create addfox-app
# or: npx create-addfox-app

Choose framework (Vanilla / Vue / React / Preact / Svelte / Solid), language, package manager, entries, and optional Skills. A full layout and addfox.config are generated.

Existing project:

pnpm add -D addfox

Add addfox.config.ts (or .js / .mjs) in the project root and entries under app/ (or appDir). Then:

  • addfox dev β€” dev with watch + HMR
  • addfox build β€” output to .addfox/extension (and optional zip)

Use -b chrome or -b firefox to target a browser.


Full docs, config reference, and examples: https://addfox.dev
Skills (AI workflow modules): https://github.com/addfox/skills