Ryan Wang
7fab0c6039
Add a new .agents/skills/halo-theme-dev skill providing Halo theme development resources: two theme templates (theme-vite and theme-minimal) with theme.yaml/settings, Vite config, package.json, CSS and JS assets, and a full set of Thymeleaf template files/partials. Include comprehensive reference docs (structure & config, finder APIs, global variables, annotations, static resources, packaging, official plugins, thymeleaf tips) and an agents/openai.yaml interface. Also update project files: modify package.json, update tsconfig.json, add skills-lock.json, rename vite-env.d.ts and remove obsolete src/main.ts and src/styles/main.css while populating src/ with the new template files.
40 lines
1.0 KiB
Markdown
40 lines
1.0 KiB
Markdown
# Theme Packaging
|
|
|
|
Use [`@halo-dev/theme-package-cli`](https://github.com/halo-dev/theme-package-cli) to package a theme into a ZIP file for uploading to Halo Console or distributing to others.
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
npm install -g @halo-dev/theme-package-cli
|
|
```
|
|
|
|
Or run without installing via `npx`:
|
|
|
|
```bash
|
|
npx @halo-dev/theme-package-cli
|
|
```
|
|
|
|
## Usage
|
|
|
|
Run in the theme root directory (the one containing `theme.yaml`):
|
|
|
|
```bash
|
|
# Package only essential files (recommended)
|
|
theme-package
|
|
|
|
# Package all files (excluding node_modules, dist, .git, etc.)
|
|
theme-package --all
|
|
```
|
|
|
|
## Default Package Contents (without `--all`)
|
|
|
|
| Included | Description |
|
|
| -------- | ----------- |
|
|
| `templates/` | Templates and static assets |
|
|
| `*.yaml` / `*.yml` | Config files: `theme.yaml`, `settings.yaml`, etc. |
|
|
| `i18n/` | Internationalization files (if present) |
|
|
| `README.md` | Documentation file (if present) |
|
|
| `LICENSE` | License file (if present) |
|
|
|
|
> For Vite-based themes, run `npm run build` first to generate the `templates/` output, then run the packaging command.
|