create-addfox-app 0.1.1-beta.15 → 0.1.1-beta.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-addfox-app",
3
- "version": "0.1.1-beta.15",
3
+ "version": "0.1.1-beta.16",
4
4
  "description": "Interactive scaffolder for addfox extension projects",
5
5
  "license": "MIT",
6
6
  "type": "module",
@@ -17,7 +17,7 @@
17
17
  "prompts": "^2.4.2",
18
18
  "kolorist": "^1.8.0",
19
19
  "minimist": "^1.2.8",
20
- "@addfox/pkg-manager": "0.1.1-beta.8"
20
+ "@addfox/pkg-manager": "0.1.1-beta.9"
21
21
  },
22
22
  "devDependencies": {
23
23
  "@rslib/core": "^0.20.0",
@@ -0,0 +1,54 @@
1
+ # AI Agent Guide - Preact Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ Preact browser extension using Addfox build tool. Uses `@rsbuild/plugin-preact` for JSX support.
8
+
9
+ ## Key Configuration Fields (addfox.config.js)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginPreact()` for JSX support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory
24
+ - **`entry`** - Manual entry mapping
25
+ - **`hotReload`** - Dev server settings
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories. Each needs `index.jsx` as entry.
33
+
34
+ ## Framework-Specific Notes
35
+
36
+ ### Preact
37
+
38
+ - JSX-based (`.jsx` files)
39
+ - React-compatible API with smaller bundle size
40
+
41
+ ### Browser Extension APIs
42
+
43
+ - Install `webextension-polyfill` for cross-browser compatibility
44
+
45
+ ### Styling
46
+
47
+ - Supports CSS Modules
48
+ - Content scripts: use `@addfox/utils` with Shadow DOM
49
+
50
+ ## Resources
51
+
52
+ - Addfox docs: https://addfox.dev
53
+ - Rsbuild Preact plugin: https://rsbuild.dev/plugins/list/plugin-preact
54
+ - Preact docs: https://preactjs.com
@@ -0,0 +1,61 @@
1
+ # AI Agent Guide - Preact Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ Preact browser extension using Addfox build tool. Uses `@rsbuild/plugin-preact` for JSX support.
8
+
9
+ ## Key Configuration Fields (addfox.config.ts)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginPreact()` for JSX support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory
24
+ - **`entry`** - Manual entry mapping
25
+ - **`hotReload`** - Dev server settings
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories:
33
+
34
+ - `app/background/` → Service Worker (index.ts)
35
+ - `app/content/` → Content Script (index.ts)
36
+ - `app/popup/` → Popup page (index.tsx + App.tsx)
37
+ - `app/options/` → Options page
38
+ - `app/sidepanel/` → Side panel
39
+
40
+ ## Framework-Specific Notes
41
+
42
+ ### Preact
43
+
44
+ - JSX-based (`.tsx` files)
45
+ - React-compatible API with smaller bundle size
46
+ - TypeScript support enabled
47
+
48
+ ### Browser Extension APIs
49
+
50
+ - Install `webextension-polyfill` for cross-browser compatibility
51
+
52
+ ### Styling
53
+
54
+ - Supports CSS Modules
55
+ - Content scripts: use `@addfox/utils` with Shadow DOM
56
+
57
+ ## Resources
58
+
59
+ - Addfox docs: https://addfox.dev
60
+ - Rsbuild Preact plugin: https://rsbuild.dev/plugins/list/plugin-preact
61
+ - Preact docs: https://preactjs.com
@@ -0,0 +1,66 @@
1
+ # AI Agent Guide - React Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ React-based browser extension using Addfox build tool. Uses `@rsbuild/plugin-react` for JSX support and React Fast Refresh.
8
+
9
+ ## Key Configuration Fields (addfox.config.js)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants for browser-specific differences
15
+ - Addfox auto-injects entry paths - don't hardcode them
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginReact()` for JSX support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory (default: ".addfox/extension")
24
+ - **`entry`** - Manual entry mapping (when auto-discovery fails)
25
+ - **`hotReload`** - Dev server settings (port, auto-refresh)
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories:
33
+
34
+ - `app/background/` → Service Worker
35
+ - `app/content/` → Content Script
36
+ - `app/popup/` → Popup page
37
+ - `app/options/` → Options page
38
+ - `app/sidepanel/` → Side panel
39
+ - `app/devtools/` → DevTools page
40
+
41
+ Each needs `index.jsx` as entry point.
42
+
43
+ ## Framework-Specific Notes
44
+
45
+ ### React/JSX
46
+
47
+ - Files use `.jsx` extension
48
+ - React Fast Refresh enabled in dev mode
49
+ - JSX transform automatic
50
+
51
+ ### Browser Extension APIs
52
+
53
+ - Install `webextension-polyfill` for cross-browser compatibility
54
+ - Import: `import browser from "webextension-polyfill"`
55
+
56
+ ### Styling
57
+
58
+ - Supports CSS Modules
59
+ - Supports Tailwind if configured
60
+ - Content scripts: use `@addfox/utils` with Shadow DOM for isolation
61
+
62
+ ## Resources
63
+
64
+ - Addfox docs: https://addfox.dev
65
+ - Rsbuild React plugin: https://rsbuild.dev/plugins/list/plugin-react
66
+ - WebExtension API: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API
@@ -0,0 +1,93 @@
1
+ # AI Agent Guide - React Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ React-based browser extension using Addfox build tool. Uses `@rsbuild/plugin-react` for JSX/TSX support and React Fast Refresh.
8
+
9
+ ## Key Configuration Fields (addfox.config.ts)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants for browser-specific differences
15
+ - Addfox auto-injects entry paths (popup, background, etc.) - don't hardcode them
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginReact()` for JSX/TSX support
19
+ - Add other Rsbuild plugins as needed
20
+
21
+ ### Optional Fields (use when needed)
22
+
23
+ - **`appDir`** - Source directory (default: "app")
24
+ - Change if source files are in a different folder
25
+
26
+ - **`outDir`** - Build output directory (default: ".addfox/extension")
27
+ - Change for custom output location
28
+
29
+ - **`entry`** - Manual entry point mapping
30
+ - Only needed when auto-discovery fails or custom structure
31
+
32
+ - **`hotReload`** - Dev server settings
33
+ - `port`: WebSocket port (default: 23333)
34
+ - `autoRefreshContentPage`: Auto-refresh on content changes
35
+
36
+ - **`debug`** - Enable debug logging (default: false)
37
+
38
+ - **`zip`** - Output zip configuration for distribution
39
+
40
+ - **`rsbuild`** - Override Rsbuild configuration directly
41
+
42
+ ## Entry Structure
43
+
44
+ Entries auto-discovered from `appDir` subdirectories:
45
+
46
+ - `app/background/` → Service Worker
47
+ - `app/content/` → Content Script
48
+ - `app/popup/` → Popup page
49
+ - `app/options/` → Options page
50
+ - `app/sidepanel/` → Side panel
51
+ - `app/devtools/` → DevTools page
52
+
53
+ Each needs `index.tsx` as entry point.
54
+
55
+ ## Framework-Specific Notes
56
+
57
+ ### React/JSX
58
+
59
+ - Files use `.tsx` extension
60
+ - React Fast Refresh enabled in dev mode
61
+ - JSX transform automatic (no need to import React)
62
+
63
+ ### Browser Extension APIs
64
+
65
+ - Install `webextension-polyfill` for cross-browser compatibility
66
+ - Import: `import browser from "webextension-polyfill"`
67
+
68
+ ### Styling
69
+
70
+ - Supports CSS Modules: `import styles from "./App.module.css"`
71
+ - Supports Tailwind if configured
72
+ - For content scripts: use `@addfox/utils` with Shadow DOM for isolation
73
+
74
+ ## Common Tasks
75
+
76
+ Adding a new entry:
77
+ 1. Create `app/<entry-name>/index.tsx`
78
+ 2. Addfox auto-detects - no config change needed
79
+ 3. Reference in manifest if needed (paths auto-injected)
80
+
81
+ Adding permissions:
82
+ 1. Edit `manifest.permissions` in config
83
+ 2. Firefox may need different permission format
84
+
85
+ Cross-browser manifest differences:
86
+ - Use `manifest.chromium` and `manifest.firefox` objects
87
+ - Common fields go in both, differences separated
88
+
89
+ ## Resources
90
+
91
+ - Addfox docs: https://addfox.dev
92
+ - Rsbuild React plugin: https://rsbuild.dev/plugins/list/plugin-react
93
+ - WebExtension API: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API
@@ -0,0 +1,54 @@
1
+ # AI Agent Guide - Solid Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ SolidJS browser extension using Addfox build tool. Uses `@rsbuild/plugin-solid` for Solid support.
8
+
9
+ ## Key Configuration Fields (addfox.config.js)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginSolid()` for Solid JSX support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory
24
+ - **`entry`** - Manual entry mapping
25
+ - **`hotReload`** - Dev server settings
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories. Each needs `index.jsx` as entry.
33
+
34
+ ## Framework-Specific Notes
35
+
36
+ ### SolidJS
37
+
38
+ - JSX-based (`.jsx` files)
39
+ - Fine-grained reactivity with signals
40
+
41
+ ### Browser Extension APIs
42
+
43
+ - Install `webextension-polyfill` for cross-browser compatibility
44
+
45
+ ### Styling
46
+
47
+ - Supports CSS Modules
48
+ - Content scripts: use `@addfox/utils` with Shadow DOM
49
+
50
+ ## Resources
51
+
52
+ - Addfox docs: https://addfox.dev
53
+ - Rsbuild Solid plugin: https://rsbuild.dev/plugins/list/plugin-solid
54
+ - Solid docs: https://www.solidjs.com
@@ -0,0 +1,61 @@
1
+ # AI Agent Guide - Solid Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ SolidJS browser extension using Addfox build tool. Uses `@rsbuild/plugin-solid` for Solid support.
8
+
9
+ ## Key Configuration Fields (addfox.config.ts)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginSolid()` for Solid JSX support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory
24
+ - **`entry`** - Manual entry mapping
25
+ - **`hotReload`** - Dev server settings
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories:
33
+
34
+ - `app/background/` → Service Worker (index.ts)
35
+ - `app/content/` → Content Script (index.ts)
36
+ - `app/popup/` → Popup page (index.tsx + App.tsx)
37
+ - `app/options/` → Options page
38
+ - `app/sidepanel/` → Side panel
39
+
40
+ ## Framework-Specific Notes
41
+
42
+ ### SolidJS
43
+
44
+ - JSX-based (`.tsx` files)
45
+ - Fine-grained reactivity with signals
46
+ - TypeScript support enabled
47
+
48
+ ### Browser Extension APIs
49
+
50
+ - Install `webextension-polyfill` for cross-browser compatibility
51
+
52
+ ### Styling
53
+
54
+ - Supports CSS Modules
55
+ - Content scripts: use `@addfox/utils` with Shadow DOM
56
+
57
+ ## Resources
58
+
59
+ - Addfox docs: https://addfox.dev
60
+ - Rsbuild Solid plugin: https://rsbuild.dev/plugins/list/plugin-solid
61
+ - Solid docs: https://www.solidjs.com
@@ -0,0 +1,54 @@
1
+ # AI Agent Guide - Svelte Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ Svelte browser extension using Addfox build tool. Uses `@rsbuild/plugin-svelte` for Svelte support.
8
+
9
+ ## Key Configuration Fields (addfox.config.js)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginSvelte()` for Svelte support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory
24
+ - **`entry`** - Manual entry mapping
25
+ - **`hotReload`** - Dev server settings
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories. Each needs `index.js` as entry.
33
+
34
+ ## Framework-Specific Notes
35
+
36
+ ### Svelte
37
+
38
+ - Single File Components (`.svelte` files)
39
+ - Reactive statements with `$:`
40
+
41
+ ### Browser Extension APIs
42
+
43
+ - Install `webextension-polyfill` for cross-browser compatibility
44
+
45
+ ### Styling
46
+
47
+ - Svelte scoped styles by default
48
+ - Content scripts: use `@addfox/utils` with Shadow DOM
49
+
50
+ ## Resources
51
+
52
+ - Addfox docs: https://addfox.dev
53
+ - Rsbuild Svelte plugin: https://rsbuild.dev/plugins/list/plugin-svelte
54
+ - Svelte docs: https://svelte.dev
@@ -0,0 +1,61 @@
1
+ # AI Agent Guide - Svelte Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ Svelte browser extension using Addfox build tool. Uses `@rsbuild/plugin-svelte` for Svelte support.
8
+
9
+ ## Key Configuration Fields (addfox.config.ts)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginSvelte()` for Svelte support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory
24
+ - **`entry`** - Manual entry mapping
25
+ - **`hotReload`** - Dev server settings
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories:
33
+
34
+ - `app/background/` → Service Worker (index.ts)
35
+ - `app/content/` → Content Script (index.ts)
36
+ - `app/popup/` → Popup page (index.ts + App.svelte)
37
+ - `app/options/` → Options page
38
+ - `app/sidepanel/` → Side panel
39
+
40
+ ## Framework-Specific Notes
41
+
42
+ ### Svelte
43
+
44
+ - Single File Components (`.svelte` files)
45
+ - TypeScript support in `<script lang="ts">`
46
+ - Reactive statements with `$:`
47
+
48
+ ### Browser Extension APIs
49
+
50
+ - Install `webextension-polyfill` for cross-browser compatibility
51
+
52
+ ### Styling
53
+
54
+ - Svelte scoped styles by default
55
+ - Content scripts: use `@addfox/utils` with Shadow DOM
56
+
57
+ ## Resources
58
+
59
+ - Addfox docs: https://addfox.dev
60
+ - Rsbuild Svelte plugin: https://rsbuild.dev/plugins/list/plugin-svelte
61
+ - Svelte docs: https://svelte.dev
@@ -0,0 +1,52 @@
1
+ # AI Agent Guide - Vanilla Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ Vanilla JavaScript browser extension using Addfox build tool. No framework plugins needed.
8
+
9
+ ## Key Configuration Fields (addfox.config.js)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ ### Optional Fields (use when needed)
18
+
19
+ - **`appDir`** - Source directory (default: "app")
20
+ - **`outDir`** - Build output directory
21
+ - **`entry`** - Manual entry mapping
22
+ - **`hotReload`** - Dev server settings
23
+ - **`debug`** - Enable debug logging
24
+ - **`zip`** - Output zip configuration
25
+ - **`rsbuild`** - Override Rsbuild configuration
26
+ - **`plugins`** - Add Rsbuild plugins if needed
27
+
28
+ ## Entry Structure
29
+
30
+ Entries auto-discovered from `appDir` subdirectories. Each needs `index.js` as entry.
31
+
32
+ ## Notes
33
+
34
+ ### JavaScript
35
+
36
+ - Pure JavaScript without framework
37
+ - DOM APIs available directly
38
+
39
+ ### Browser Extension APIs
40
+
41
+ - Install `webextension-polyfill` for cross-browser compatibility
42
+ - Or use `chrome.*` APIs directly
43
+
44
+ ### Styling
45
+
46
+ - Plain CSS
47
+ - Content scripts: use `@addfox/utils` with Shadow DOM
48
+
49
+ ## Resources
50
+
51
+ - Addfox docs: https://addfox.dev
52
+ - WebExtension API: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API
@@ -0,0 +1,59 @@
1
+ # AI Agent Guide - Vanilla Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ Vanilla TypeScript browser extension using Addfox build tool. No framework plugins needed.
8
+
9
+ ## Key Configuration Fields (addfox.config.ts)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ ### Optional Fields (use when needed)
18
+
19
+ - **`appDir`** - Source directory (default: "app")
20
+ - **`outDir`** - Build output directory
21
+ - **`entry`** - Manual entry mapping
22
+ - **`hotReload`** - Dev server settings
23
+ - **`debug`** - Enable debug logging
24
+ - **`zip`** - Output zip configuration
25
+ - **`rsbuild`** - Override Rsbuild configuration
26
+ - **`plugins`** - Add Rsbuild plugins if needed (no framework plugin required)
27
+
28
+ ## Entry Structure
29
+
30
+ Entries auto-discovered from `appDir` subdirectories:
31
+
32
+ - `app/background/` → Service Worker (index.ts)
33
+ - `app/content/` → Content Script (index.ts)
34
+ - `app/popup/` → Popup page (index.ts + HTML)
35
+ - `app/options/` → Options page
36
+ - `app/sidepanel/` → Side panel
37
+
38
+ ## Notes
39
+
40
+ ### TypeScript
41
+
42
+ - Pure TypeScript without framework
43
+ - DOM APIs available directly
44
+ - No JSX transform needed
45
+
46
+ ### Browser Extension APIs
47
+
48
+ - Install `webextension-polyfill` for cross-browser compatibility
49
+ - Or use `chrome.*` APIs directly
50
+
51
+ ### Styling
52
+
53
+ - Plain CSS or CSS Modules
54
+ - Content scripts: use `@addfox/utils` with Shadow DOM
55
+
56
+ ## Resources
57
+
58
+ - Addfox docs: https://addfox.dev
59
+ - WebExtension API: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API
@@ -0,0 +1,60 @@
1
+ # AI Agent Guide - Vue Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ Vue 3 browser extension using Addfox build tool. Uses `@rsbuild/plugin-vue` for SFC support.
8
+
9
+ ## Key Configuration Fields (addfox.config.js)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginVue()` for Vue SFC support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory
24
+ - **`entry`** - Manual entry mapping
25
+ - **`hotReload`** - Dev server settings
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories:
33
+
34
+ - `app/background/` → Service Worker (index.js)
35
+ - `app/content/` → Content Script (index.js)
36
+ - `app/popup/` → Popup page (index.js + App.vue)
37
+ - `app/options/` → Options page
38
+ - `app/sidepanel/` → Side panel
39
+
40
+ ## Framework-Specific Notes
41
+
42
+ ### Vue 3
43
+
44
+ - Uses Vue 3 Composition API
45
+ - Single File Components (`.vue` files)
46
+
47
+ ### Browser Extension APIs
48
+
49
+ - Install `webextension-polyfill` for cross-browser compatibility
50
+
51
+ ### Styling
52
+
53
+ - Vue scoped styles supported
54
+ - Content scripts: use `@addfox/utils` with Shadow DOM
55
+
56
+ ## Resources
57
+
58
+ - Addfox docs: https://addfox.dev
59
+ - Rsbuild Vue plugin: https://rsbuild.dev/plugins/list/plugin-vue
60
+ - Vue 3 docs: https://vuejs.org
@@ -0,0 +1,65 @@
1
+ # AI Agent Guide - Vue Addfox Extension
2
+
3
+ > **Priority**: Follow `.agents/skills/` first, then this guide, then [official docs](https://addfox.dev)
4
+
5
+ ## Project Overview
6
+
7
+ Vue 3 browser extension using Addfox build tool. Uses `@rsbuild/plugin-vue` for SFC support.
8
+
9
+ ## Key Configuration Fields (addfox.config.ts)
10
+
11
+ ### Required Fields
12
+
13
+ - **`manifest`** - Extension manifest.json content
14
+ - Supports `chromium` and `firefox` variants
15
+ - Addfox auto-injects entry paths
16
+
17
+ - **`plugins`** - Rsbuild plugins array
18
+ - Must include `pluginVue()` for Vue SFC support
19
+
20
+ ### Optional Fields (use when needed)
21
+
22
+ - **`appDir`** - Source directory (default: "app")
23
+ - **`outDir`** - Build output directory (default: ".addfox/extension")
24
+ - **`entry`** - Manual entry mapping (when auto-discovery fails)
25
+ - **`hotReload`** - Dev server settings
26
+ - **`debug`** - Enable debug logging
27
+ - **`zip`** - Output zip configuration
28
+ - **`rsbuild`** - Override Rsbuild configuration
29
+
30
+ ## Entry Structure
31
+
32
+ Entries auto-discovered from `appDir` subdirectories:
33
+
34
+ - `app/background/` → Service Worker (index.ts)
35
+ - `app/content/` → Content Script (index.ts)
36
+ - `app/popup/` → Popup page (index.ts + App.vue)
37
+ - `app/options/` → Options page
38
+ - `app/sidepanel/` → Side panel
39
+ - `app/devtools/` → DevTools page
40
+
41
+ ## Framework-Specific Notes
42
+
43
+ ### Vue 3
44
+
45
+ - Uses Vue 3 Composition API
46
+ - Single File Components (`.vue` files)
47
+ - TypeScript support enabled
48
+
49
+ ### Browser Extension APIs
50
+
51
+ - Install `webextension-polyfill` for cross-browser compatibility
52
+ - Use in setup scripts or component methods
53
+
54
+ ### Styling
55
+
56
+ - Vue scoped styles supported
57
+ - CSS Modules available
58
+ - Content scripts: use `@addfox/utils` with Shadow DOM
59
+
60
+ ## Resources
61
+
62
+ - Addfox docs: https://addfox.dev
63
+ - Rsbuild Vue plugin: https://rsbuild.dev/plugins/list/plugin-vue
64
+ - Vue 3 docs: https://vuejs.org
65
+ - WebExtension API: https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API