Hugoifier

AI-powered Hugo theme converter with Decap CMS integration.

https://hugoifier.dev | https://github.com/ConflictHQ/hugoifier

Overview

Hugoifier converts any HTML/CSS theme into a production-ready Hugo site -- complete with layouts, content structure, and a fully configured Decap CMS admin panel. Supports Anthropic Claude, OpenAI GPT-4, and Google Gemini as AI backends.

Features

• HTML to Hugo -- AI converts raw HTML/CSS templates into valid Hugo Go template files with proper partials, blocks, and template variables
• Multi-backend AI -- Route to Anthropic (default), OpenAI, or Google Gemini
• Decap CMS out of the box -- Auto-generates config by introspecting your content structure
• Hugo API modernization -- Automatically patches deprecated Hugo APIs for Hugo >= v0.128
• Whitelabel CMS -- Customize the Decap admin panel name, logo, and color per deployment
• Smart theme detection -- Handles messy zip-extracted directory structures, skips __MACOSX artifacts
• Docker support -- Fully containerized with docker-compose.yml

Quick Start

pip install -r requirements.txt
export ANTHROPIC_API_KEY=your_key_here
python src/cli.py complete themes/my-theme
cd output/my-theme && hugo serve

Pipeline

Input (Hugo theme or raw HTML)
    -> Theme Finder (detect Hugo theme vs raw HTML)
    -> Hugoify (AI converts HTML to Hugo layouts)
    -> Assemble (copy theme + exampleSite, write hugo.toml)
    -> Theme Patcher (fix deprecated Hugo APIs)
    -> Decapify (generate Decap CMS config)
    -> output/{theme-name}/ (ready to run with hugo serve)

Requirements

• Python 3.11+
• At least one AI API key
• Hugo extended (for building the output site)

MIT License -- CONFLICT LLC