Hugo Theme Puma is a single-column theme for the Hugo static site generator, built for minimal blogs and offering Cloudflare Worker support for serverless deployment. It is created by GitHub user bigfa and distributed as an open-source repository at https://github.com/bigfa/hugo-theme-puma.
What is Hugo Theme Puma?
Hugo Theme Puma is a single-column Hugo theme that renders Markdown content into a clean blog layout. It includes Cloudflare Worker support, which means the theme is designed to work with serverless deployments on Cloudflare's edge network. The theme is installed as a git submodule, and its configuration is set with a single line in config.toml. Release notes track compatibility with Hugo v0.146.0 as of version 0.0.8.
Key Features
- Single-column layout — focuses content into one main column for distraction-free reading.
- Cloudflare Worker support — enables deploying a Hugo site on Cloudflare's global edge network.
- Custom pagination — introduced in v0.1.1, allowing control over how posts are split into pages.
- Search — the v0.0.7 fix for search errors confirms a built-in site search feature.
- Post view counts — added in v0.0.6, showing the number of views per post.
- Author information — included since v0.0.4, displaying author details on posts.
- Related posts — added in v0.0.2, automatically linking to related content.
- Inset post shortcode — available from v0.0.3, letting authors embed inset-style blocks within posts.
- CSS variables — since v0.0.2, the theme exposes design tokens for easy customization.
- Translation support — release notes repeatedly mention translation updates, indicating localization for multiple languages.
Who should use Hugo Theme Puma?
- Personal bloggers who want a clean, minimal single-column design for their writing.
- Hugo developers looking for a theme that works on Cloudflare Workers for edge-based hosting.
- Self-hosted site owners who need built-in search, related posts, and view counters without heavy dependencies.
What can you do with Hugo Theme Puma?
- Writers: publish articles in a distraction-free layout, using the inset post shortcode to highlight quotes or notes.
- Developers: deploy a blog to Cloudflare's global network with the theme's worker support, using Hugo's static output.
- Site maintainers: track content engagement with the post view counter and help readers discover more through related post links.
How does Hugo Theme Puma work?
The setup requires adding the theme as a git submodule from the repository URL https://github.com/bigfa/hugo-theme-puma.git into the themes/puma directory, then updating config.toml with theme = 'puma'. Beyond installation, the theme relies on standard Hugo content and configuration; the README documents no other workflow.
FAQ
Is Hugo Theme Puma free?
Yes, it is an open-source theme hosted on GitHub. The repository is public and does not mention any paid license.
How do I install Hugo Theme Puma?
Run git submodule add https://github.com/bigfa/hugo-theme-puma.git themes/puma inside your Hugo site directory, then append theme = 'puma' to config.toml.
Does Hugo Theme Puma have search?
Yes, the version history includes a fix for search errors in v0.0.7, confirming the theme ships with a search feature.
What Hugo version does Hugo Theme Puma require?
The v0.0.8 release notes state compatibility with Hugo v0.146.0, so recent Hugo versions should work with the theme.
