Zip Packaging

After build, Addfox automatically packages the output directory into a zip file for distribution.

Default Behavior

pnpm
npm
yarn
bun
pnpm build

After build completes:

.addfox
extension# Build output
extension.zip# Package file

Configuration

Disable Packaging

// addfox.config.ts
export default defineConfig({
  zip: false,
});

Enable Packaging (Default)

// addfox.config.ts
export default defineConfig({
  zip: true,
});

Or omit configuration (uses default).

Package Contents

The zip file contains all build output:

  • manifest.json — Extension manifest
  • background/ — Background scripts
  • content/ — Content scripts
  • popup/ — Popup page
  • options/ — Options page
  • Other entries
  • Static assets from public/ (icons, i18n files, etc.)

Usage

Packaged zip files can be used for:

Chrome Web Store Submission

  1. Visit Chrome Web Store Developer Dashboard
  2. Create or select a project
  3. Upload extension.zip

Firefox Add-ons Submission

  1. Visit Firefox Add-ons Developer Hub
  2. Submit new add-on
  3. Upload extension.zip

Internal Distribution

  • Share via email/cloud storage
  • Internal test deployment

Output Path

Package file output path:

{outputRoot}/{outDir}.zip

Default: .addfox/extension.zip

After modifying outDir:

export default defineConfig({
  outDir: "dist",
});
// Output: .addfox/dist.zip
  • zip - Zip packaging toggle
  • outDir - Output directory configuration