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 +2 -2
- package/templates/template-preact-js/AGENTS.md +54 -0
- package/templates/template-preact-ts/AGENTS.md +61 -0
- package/templates/template-react-js/AGENTS.md +66 -0
- package/templates/template-react-ts/AGENTS.md +93 -0
- package/templates/template-solid-js/AGENTS.md +54 -0
- package/templates/template-solid-ts/AGENTS.md +61 -0
- package/templates/template-svelte-js/AGENTS.md +54 -0
- package/templates/template-svelte-ts/AGENTS.md +61 -0
- package/templates/template-vanilla-js/AGENTS.md +52 -0
- package/templates/template-vanilla-ts/AGENTS.md +59 -0
- package/templates/template-vue-js/AGENTS.md +60 -0
- package/templates/template-vue-ts/AGENTS.md +65 -0
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "create-addfox-app",
|
|
3
|
-
"version": "0.1.1-beta.
|
|
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.
|
|
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
|