contentbox-boxlang-theme-developmentlisted
Install: claude install-skill ColdBox/skills
# ContentBox Theme Development (BoxLang)
Build custom themes for ContentBox CMS using BoxLang. Themes control the visual presentation of all public-facing content — blog entries, pages, archives, search results, and error pages.
## Theme Structure
A ContentBox theme is a directory under `modules_app/contentbox-custom/_themes/` (custom) or `modules/contentbox/themes/` (core) containing:
```
MyTheme/
├── Theme.bx ← Theme metadata, settings, lifecycle callbacks
├── screenshot.png ← Theme preview image (shown in admin)
├── layouts/
│ ├── blog.bx ← MANDATORY: Blog entry layout
│ └── pages.bx ← MANDATORY: Page layout
│ ├── maintenance.bx ← Optional: Maintenance mode layout
│ └── search.bx ← Optional: Search results layout (defaults to pages)
├── views/
│ ├── index.bx ← MANDATORY: Home page (blog entry listing)
│ ├── entry.bx ← MANDATORY: Single blog entry with comments
│ ├── page.bx ← MANDATORY: Single page rendering
│ ├── archives.bx ← MANDATORY: Blog archives view
│ ├── error.bx ← MANDATORY: Error display
│ ├── notfound.bx ← Optional: Entry not found view
│ └── maintenance.bx ← Optional: Maintenance mode view
├── templates/
│ ├── entry.bx ← Collection template for entry iterations
│ ├── category.bx ← Collection template for category iterations
│ └── comment.bx ← Collection template for comment iterations
├── wi