Architecture

Pipeline

flowchart TD
    A[Input path] --> B{Hugo theme?}
    B -- Yes --> C[find_hugo_theme]
    B -- No --> D[find_raw_html_files]

    C --> E[Copy theme → themes/name/]
    E --> F[Copy exampleSite content/data/static]
    F --> G[Write hugo.toml]
    G --> H[patch_theme + patch_config]
    H --> I[decapify]

    D --> J[hugoify_html via AI]
    J --> K[Write layouts/]
    K --> L[Copy CSS/JS/images]
    L --> M[Write minimal hugo.toml]
    M --> I

    I --> N[output/theme-name/]

Module Map

| Module | Responsibility |

|---|

| src/cli.py | Argument parsing, logging setup, error handling |

| src/config.py | Multi-backend AI routing (call_ai) |

| src/utils/complete.py | Full pipeline orchestration |

| src/utils/theme_finder.py | Locate Hugo theme + exampleSite within messy extracted directories |

| src/utils/hugoify.py | AI-powered HTML → Hugo layout conversion |

| src/utils/decapify.py | Generate Decap CMS index.html + config.yml |

| src/utils/theme_patcher.py | Patch deprecated Hugo APIs in layout files and config |

| src/utils/analyze.py | Theme structure reporting + AI-powered HTML analysis |

| src/utils/translate.py | AI content translation |

| src/utils/deploy.py | Cloudflare deployment (stub) |

| src/utils/cloudflare.py | Cloudflare configuration (stub) |

| src/utils/parser.py | HTML/CSS linting (stub) |

AI Backends

All AI calls route through a single call_ai(prompt, system) function in src/config.py. Switch backends via HUGOIFIER_BACKEND:

| Backend | Default Model | Env Var |

|---|

| anthropic (default) | claude-sonnet-4-6 | ANTHROPIC_API_KEY |

| openai | gpt-4-turbo | OPENAI_API_KEY |

| google | gemini-1.5-pro | GOOGLE_API_KEY |

Hugo API Patching

theme_patcher.py handles breaking changes in Hugo ≥ v0.128:

Template patches:

| Old | New |

|---|

| .Site.DisqusShortname | .Site.Config.Services.Disqus.Shortname |

| .Site.GoogleAnalytics | .Site.Config.Services.GoogleAnalytics.ID |

Config patches (hugo.toml):

| Old | New |

|---|

| paginate = N | [pagination] pagerSize = N |

| googleAnalytics = "UA-..." | [services.googleAnalytics] id = "UA-..." |

| disqusShortname = "..." | [services.disqus] shortname = "..." |

Decap CMS Generation

decapify.py introspects content/ to build Decap collections:

• Folder collection — subdirectory with .md files at any depth (blog, posts, etc.)

• File collection — subdirectory with only _index.md (about, contact, etc.)

Field types are inferred from YAML frontmatter values: string, text, datetime, image, list, boolean, number, markdown.

Output Structure

output/{theme-name}/
├── hugo.toml              # Site config (modernized)
├── content/               # From exampleSite or minimal stub
├── data/                  # From exampleSite (if present)
├── static/
│   └── admin/
│       ├── index.html     # Decap CMS UI
│       └── config.yml     # Decap collections config
└── themes/
└── {theme-name}/      # Patched Hugo theme
├── layouts/
├── static/
└── archetypes/

Z f0e03e0acc8d7081428d0e44bc00f301