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.
1.0 KiB
1.0 KiB
Theme Packaging
Use @halo-dev/theme-package-cli to package a theme into a ZIP file for uploading to Halo Console or distributing to others.
Installation
npm install -g @halo-dev/theme-package-cli
Or run without installing via npx:
npx @halo-dev/theme-package-cli
Usage
Run in the theme root directory (the one containing theme.yaml):
# 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 buildfirst to generate thetemplates/output, then run the packaging command.