#Config-based Entry

When configuring with entry and manifest in addfox.config.ts, you can:

• Customize entry paths
• Override auto-discovery results
• Add custom entries (e.g., capture, my-page)

Entries not listed in entry will still be auto-discovered via file-based rules.

#Core Principles

Consistent with file-based entries:

• Entries must be JS/TS: Built on Rsbuild, real entries can only be script files
• HTML handling: Built-in HTML entries (popup/options, etc.) auto-generate; when using custom HTML templates, must mark entry script with data-addfox-entry

#Configuration Methods

#1) Configure via entry

entry is an object: key = entry name, value = path or config object.

#2) Configure entry-related fields via manifest

In manifest, declare entry-related capability fields (e.g., background, action.default_popup, content_scripts):

export default defineConfig({
  manifest: {
    manifest_version: 3,
    background: { service_worker: "background/index.js" },
    action: { default_popup: "popup/index.html" },
    content_scripts: [
      { matches: ["<all_urls>"], js: ["content/index.js"] },
    ],
  },
});

#3) Priority between entry and manifest

When both participate in entry resolution, the priority is:

1. Explicit configuration in entry
2. Entry-related fields in manifest
3. Auto-discovery (file-based)

That is: entry will override entries from other sources with the same name.

#String path (recommended)

Value is a path relative to baseDir (default app/):

#Object form: { src, html? }

More fine-grained control:

#Built-in Entries and Output Paths

When configuring built-in entries via entry, default output paths are as follows:

#Configuration Examples

#Override some entries

// addfox.config.ts
import { defineConfig } from "addfox";

export default defineConfig({
  entry: {
    // Only override these entries, others still auto-discovered
    popup: "popup/main.tsx",
    options: "options/settings.tsx",
  },
});

#Configure all entries completely

export default defineConfig({
  appDir: "src",
  entry: {
    background: "background/index.ts",
    content: "content/index.ts",
    popup: "popup/index.tsx",
    options: "options/index.tsx",
    sidepanel: "sidepanel/index.tsx",
  },
});

#Custom entry + force HTML generation

export default defineConfig({
  entry: {
    // Built-in entries
    background: "background/index.ts",
    content: "content/index.ts",
    popup: "popup/index.tsx",
    
    // Custom page entry (auto-generate HTML)
    capture: { src: "pages/capture/index.tsx", html: true },
    
    // Custom page entry (use template)
    welcome: { src: "pages/welcome/index.tsx", html: "pages/welcome/template.html" },
    
    // Script-only entry (no HTML)
    worker: { src: "worker/index.ts", html: false },
  },
});

#Disable entry auto-discovery

If you need full manual control of all entries:

export default defineConfig({
  entry: {
    background: "background/index.ts",
    content: "content/index.ts",
    popup: "popup/index.tsx",
    // ... list all required entries
  },
  // Keep other config items undefined, framework only processes entries listed in entry
});

#Path Resolution Rules

#Relative to baseDir

All paths in entry are relative to baseDir, where baseDir is determined by appDir (default app):

export default defineConfig({
  appDir: "src",                    // baseDir = src/
  entry: {
    popup: "popup/index.ts",        // points to src/popup/index.ts
  },
});

#Path Quick Reference

#Next Steps

• File-based Entry — Learn auto-discovery rules
• appDir configuration — Modify source directory
• manifest configuration — Configure extension manifest