Files
halo-theme-whitespace/.agents/skills/halo-theme-dev/references/packaging.md
T
Ryan Wang 7fab0c6039 Add halo-theme-dev skill & theme templates
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.
2026-04-02 23:12:27 +08:00

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 build first to generate the templates/ output, then run the packaging command.