halo-theme-dev

Guide Halo theme development with Thymeleaf templates, theme.yaml, and Vite tooling.

9|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/halo-dev/dev-skills --skill halo-theme-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: halo-theme-dev
Source: https://github.com/halo-dev/dev-skills/tree/main/skills/halo-theme-dev
Command: npx skills add https://github.com/halo-dev/dev-skills --skill halo-theme-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and assets (resource) components.

What problem does it solve?

This guide helps developers create and customize Halo CMS themes by consolidating best practices for Thymeleaf templates, theme configuration, and Finder API usage into a single, actionable resource.

Core Features & Use Cases

  • Comprehensive development workflow covering theme structure, theme.yaml, settings.yaml, and template variables.
  • Guidance for integrating static assets, i18n, template tags, and Vite-based tooling via vite-plugin-halo-theme.
  • Starter templates and references to enable rapid prototyping and plugin integration across both traditional Thymeleaf and modern build pipelines.

Quick Start

Create a theme directory, write theme.yaml, optionally add settings.yaml, and start building templates and assets.

Frequently Asked Questions about halo-theme-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build a Halo theme with Thymeleaf and Vite?

To build a Halo theme with Thymeleaf and Vite, create a theme directory, write theme.yaml, optionally add settings.yaml, and start developing templates and assets using vite-plugin-halo-theme.

What is the Finder API used for in Halo theme development?

The Finder API in Halo theme development retrieves content data within Thymeleaf templates. It enables templates to dynamically fetch and render content managed by the Halo CMS.

Can I use Vite to manage static assets in Halo CMS themes?

Yes, you can use Vite to manage static assets in Halo CMS themes. The workflow integrates vite-plugin-halo-theme to handle asset compilation across modern build pipelines.

How do I configure theme settings using settings.yaml in Halo?

To configure theme settings in Halo, you add a settings.yaml file to your theme directory. This file defines configurable options that users can adjust within the Halo CMS interface.

Does Halo theme development require outdated training data for Thymeleaf templates?

No, Halo theme development discourages reliance on outdated training data. You should reference current Halo documentation to ensure safe coding practices and accurate Finder API usage in Thymeleaf templates.

What is the best way to integrate plugins into a Halo theme?

The best way to integrate plugins into a Halo theme is by using the provided starter templates and Finder API. This enables rapid prototyping and seamless plugin integration across both traditional Thymeleaf and modern Vite build pipelines.