Hugo Generator API
Developer tools
An API that turns typed page schemas and records into a buildable Hugo site — then publishes it.
API that stores typed page content in a database and generates the Hugo markdown needed to build a static site. Schemas define front matter shape and content paths; Pages are the individual records that become real files under content/.
Built for managing site content programmatically — including theme import, schema suggestion from theme signals, Hugo builds, and publish to Cloudflare R2.
What it does
- Schemas & records — Define page types once, then insert Pages into versioned SQLite tables
- Generate — Validate front matter and write
_index.md/{slug}.mdunder the Hugo site tree - Themes — Import theme packages, select one for the site, and infer Schemas from layouts and archetypes
- Build & publish — Run Hugo, then sync
public/to R2 through a companion publisher service
Stack highlights
| Piece | Role |
|---|---|
| Generator API | Schemas, Pages, generate, build, themes |
| Publisher | Sync build output to Cloudflare R2 |
| Swagger | Interactive docs at /swagger |
Try it
docker compose up -d --build
# API: http://localhost:8080/swagger
# Health: http://localhost:8080/health
Open source on GitHub — contributions and issues welcome.