r/gohugo • • 4d ago

My Hugo site: 3 languages, ~480 posts each, 7 themes, an onion mirror, and a console API. Roast it?

19 Upvotes

Hi r/gohugo! I've been building my personal site with Hugo since March (migrated from Wordpress) and I'd love some outside eyes on it before I keep piling on features.

Site: https://lauraesteves.com/en

What's under the hood:

  • Custom theme (SCSS + Bootstrap), trilingual (pt/en/es) with ~480 posts per language

  • 7 visual themes built with Hugo Pipes (dart-sass, each one a separate fingerprinted stylesheet loaded on demand so the default never flashes). Try ?theme=matrix or ?theme=vaporwave. There's also a hidden seasonal one 🎄

  • Easter eggs with a found-tracker and a medal. Open the console and type laura.help()

  • Tor onion mirror built from the same content with --environment onion and a layouts-onion mount that swaps out embeds and forms

  • Strict CSP where inline scripts are hashed per build, S3 + CloudFront functions, a QA environment per PR, scheduled deploys for future-dated posts

  • Weekly series (JS, Go, Rust, Java/Kotlin) with their own covers and listing widgets

  • Cookieless self-hosted Umami

Where I'd really like feedback:

  1. Does the English version read naturally, or does it feel translated?

  2. Is the home page too busy? What would you remove first?

  3. Performance on your device/connection (I mostly test from Brazil)

  4. Anything that looks broken in your browser

  5. Any Hugo patterns you'd do differently (multilingual setup, image processing, taxonomy pages)

Happy to share how any part of it works.
Thanks!


r/gohugo • • 8d ago

Just released a Persona 5-inspired hugo theme

Thumbnail
github.com
8 Upvotes

r/gohugo • • 10d ago

Documentation in French on how to use Hugo?

1 Upvotes

Hello.

Would you happen to know where I could find documentation in French on how to use Hugo?


r/gohugo • • 13d ago

I got tired of fighting static site generators to publish my notes, so I built my own app (with offline AI that runs on a normal laptop)

9 Upvotes

I write almost everything in Markdown. Notes, drafts, ideas for posts. The annoying part was always the last step: turning those notes into a website. Every time it was a static site generator, a config file, Git, a deploy pipeline. And to have the same notes on my laptop and my phone, I had to trust some company with my text.

So I built Blup, and I just shipped 1.0:

  • Blup Studio, a desktop app (Windows, macOS, Linux) where you write in Markdown and publish a site in one click

  • End-to-end encrypted sync between devices: notes are encrypted on your device, the server only stores data it can't read

  • Blup Notes, an Android app that syncs with it

  • AI that runs on your own computer, offline: translate your site between English, Portuguese and Spanish, and listen to your notes with a natural voice. I used small optimized models (an 8-bit voice model and Firefox's own translation engine) so it runs on a regular laptop's CPU, no GPU, and no text ever leaves your machine. There's also an optional cloud version if you prefer.

  • A CLI for people who live in the terminal

The apps are free and the code is open source (AGPL). There's an optional paid cloud plan for sync and hosting, which is how I plan to keep it running.

Stack, if anyone's curious: Go (Wails) for desktop and mobile, Svelte 5 for the UI, Cloudflare Workers + D1 + R2 for the backend, Stripe for billing, GitHub Actions for signed releases.

I would greatly appreciate honest feedback.

Site: getblup.io

Code: github.com/gabriellsalesx/blup


r/gohugo • • 19d ago

My self-hosted Hugo blog: server boot sequence with CLI/GUI toggle

35 Upvotes

Made a personal site using Hugo with a fully custom theme.

On load, it simulates an init sequence and lets you pick an interface via a red/blue pill prompt:

  • CLI: using terminal commands navigates posts or notes

  • GUI: Clean, static view for normal reading.

What I write about:

  • Homelab & self-hosted service configs

  • Linux distro hopping (tools, Distro reviews and obscure fixes)

  • Personal tech notes and random thoughts

Link : https://lablog.miniverse.com.co/

Feedback on the terminal handling or theme performance is welcomed.


r/gohugo • • 22d ago

Hugo Mini: the minimal theme I use for my bilingual blog

1 Upvotes

I’d like to share Hugo Mini, the open-source theme I use on my own blog.

The focus is on making articles comfortable to read, with a simple layout and support for publishing in more than one language. A few details:

  • Light and dark modes; typography adjustments happen during the Hugo build.

  • Language-aware navigation and translated interface text.

  • Fonts, styles, and core scripts hosted on your own domain.

  • Equations, diagrams, and Telegram comments available as optional features.

Demo: https://zavarov.com/en/
Code and setup: https://github.com/zavarovkv/hugo-mini
Hugo directory: https://themes.gohugo.io/themes/hugo-mini/

It uses the MIT license and requires Hugo Extended 0.146.0+.

If you try it, I’d love to hear how it feels on mobile and whether the setup instructions leave any gaps.


r/gohugo • • 24d ago

Blup: Obsidian + Hugo, with roadmap voting, reactions and comments

20 Upvotes

Hugo handles static pages well. Adding comments, reactions and voting means connecting extra pieces. I built Blup to make that setup easier.

It's an open-source Go CLI that turns Obsidian notes into a Hugo site. Its Bento theme includes docs, roadmap voting, changelog reactions and blog comments.

The pages stay static. A small API connects the interactions to issues, comments and reactions in a public GitHub feedback repo. Visitors need a GitHub account to participate.

It's MIT-licensed and publishes to Cloudflare Pages or GitHub Pages.

https://getblup.pages.dev/

How are you handling reader interaction on your Hugo sites?


r/gohugo • • 29d ago

Trying Pele as My Hugo Blog Mermaid Renderer

Thumbnail blog.nimendra.online
11 Upvotes

r/gohugo • • Oct 01 '26

How would you turn a ChatGPT-generated static site into a Hugo project that stays editable?

0 Upvotes

A generated static site can look finished while still being awkward to maintain. Repeated layouts may be copied into every HTML file, assets may use brittle relative paths, and adding one page can mean editing navigation in several places. Publishing the folder is easy; turning it into a site that can keep one URL and accept later changes is the harder part.

For Hugo, I would expect to separate page content into Markdown, move repeated markup into base templates and partials, put navigation and site-wide values in data or config, and keep generated CSS or JavaScript only where it is still understandable. The migration also needs to preserve URLs, metadata, images, forms, and any client-side behavior before switching the domain.

What workflow would you use for this conversion? Would you first deploy the generated files as-is and refactor behind a preview, or build the Hugo structure before the first public release? Which parts of generated HTML are worth preserving, and what should be rebuilt so a non-developer can add pages or edit copy later without asking the generator to rewrite the whole site?


r/gohugo • • Sep 30 '26

Self-hosted comments for Hugo that run on Cloudflare Workers

17 Upvotes

Hi all. Hugo's built-in answer for comments is still a Disqus shortcode, so I bring you something else. Garrul is a comment system that deploys into your own Cloudflare account: a Worker for the API, D1 for storage, Turnstile for spam. It ships with a Hugo partial.

What it does:

  • Threaded replies, markdown, reactions

  • Sign in with GitHub, Google, Discord, X or Facebook, or comment anonymously

  • Reply emails with one-click unsubscribe, and a comment feed for each post

  • Dark mode, themeable, 11 languages

  • A keyboard-driven mod queue, or moderate from Telegram if you prefer your phone

Coming from somewhere else? It imports from Disqus, isso, remark42, Commento and Cusdis. The comments sit in a D1 database you own, with no ads or trackers. Each page view costs one Worker request, so a normal blog stays inside the free tier.

The partial is about 15 lines and has a disableComments front-matter switch: https://github.com/KingPin/Garrul/tree/main/examples/hugo

One tip: add http://localhost:1313 to ALLOWED_ORIGINS, or hugo server won't load comments.

It is about 20KB gzipped and renders in shadow DOM, so your theme CSS and the widget don't touch each other. I built it with AI help. It has run on my own blog since June. Over 160 test files and CodeQL on every commit. Questions welcome, and if you break it, please tell me :)

Site: https://garrul.com

Repo: https://github.com/KingPin/Garrul

Screenshots: https://github.com/KingPin/Garrul/blob/main/docs/screenshots.md


r/gohugo • • Sep 17 '26

I built GitMark — edit and commit Hugo posts directly from GitHub

0 Upvotes

I maintain a Hugo blog on GitHub and often need to fix a typo, update a paragraph, or add an image. Cloning the repository and opening an IDE felt excessive for these small changes, so I built GitMark.

GitMark is an open-source Chrome extension for editing and committing Markdown files directly from GitHub.

It supports:

  • Editing existing Markdown files or creating new posts

  • Split-pane live Markdown preview

  • Pasting, dropping, or selecting images

  • Committing Markdown and images in one atomic commit

  • Detecting remote changes before updating a file

  • English and Chinese interfaces

For Hugo, I use Leaf Bundles such as:

content/post/article-name/
├── index.md
└── assets/
    └── cover.png

GitMark inserts relative image paths, so images work in both GitHub previews and the generated Hugo site.

Chrome Web Store: https://chromewebstore.google.com/detail/gitmark/ihbciobhmpfemphhdpeajkpbldmdgocb

The extension has no developer-operated server, analytics, or advertising. The GitHub token is stored locally and sent only to GitHub's official API.

I'd especially appreciate feedback on the Hugo image workflow and whether branch/PR support would be useful.


r/gohugo • • Sep 14 '26

Made a community-driven Hugo docs site

15 Upvotes

Hi all, over the past few weeks I've put together a Hugo documentation site for anyone learning Hugo. The goal is to help people understand and get productive with Hugo faster. A few things about it:

  • It's not affiliated with Hugo or the official team

  • Concept-first. Each page explains the reasoning behind a feature, not just its config options

  • Available in Chinese (written by hand) and English (AI-translated from the Chinese version, so let me know if anything reads awkwardly)

If you're learning Hugo, I'd genuinely appreciate feedback on what's unclear, wrong, or missing. And if anyone wants to contribute a page or fix something, it's open on GitHub.


r/gohugo • • Sep 11 '26

I Rebuilt My Entire Website in Astro… Was It Worth It?

Thumbnail
youtube.com
16 Upvotes

Chris Titus moved from GoHugo to Astro, but he speaks highly of GoHugo in the video, and said not to switch, except you need Twitch and other more interactive integration. Wheter you use were Astro curious, or want to stay on GoHugo, I think his video gives a good insight of static web sites in general.


r/gohugo • • Sep 06 '26

I built my own minimal Hugo portfolio theme

Post image
36 Upvotes

I spent some time to build my portfolio, using Hugo. I thought why not sharing it with you guys.

I wanted something minimal + dark and ended up with freaky - a single-page Hugo portfolio theme.

It has the usual portfolio stuff (projects, publications, blogs, socials), plus a typing hero, image flicker transitions, a backend-free contact form (frontend only), and an optional site-view counter.

The theme is completely driven by hugo.toml, so personal info isn't baked into the templates.

https://github.com/freaktopus/hugo-theme-freaky

Feedback is welcome - especially if you spot something that would make it more useful as an actual Hugo theme rather than just my personal site.

I will definitely upgrade it further, I have some cool idea to keep such as live music playing in spotify.


r/gohugo • • Sep 05 '26

Finally my hugo theme "Macchiato" got merged

17 Upvotes

I've been writing some blogs lately and wanted to choose a theme for them. My helix config, terminal, whole shell, browser.. almost full setup uses catppuccin macchiato theme. This already tells how much I love it but I couldn't find a Hugo theme that scratched the same itch, so I created this :)

That said, I built it around a "developer's terminal" feel since it's a C++/systems blog. Been using it for my blogs myself and it's on themes.gohugo.io now

Please drop your reviews if this theme looks good or not (please be kind, I used AI as a pair-programmer for a lot of the CSS/template work since frontend isn't my usual area)

Repo link- hugo-macchiato repo

Don't wanna promote my blogs here or anything but since it is in the demo - Blogs (demo site)


r/gohugo • • Sep 02 '26

I built a dynamic layer for Hugo/static sites using Cloudflare Workers + D1

Post image
5 Upvotes

I've been using static sites for a while, but eventually you run into the same problem: you want a small amount of dynamic functionality without turning the whole site into a traditional web app.

So I built StaticLayer:

https://abla25.github.io/StaticLayer/

It adds comments, replies, reactions and polls to static sites.

The architecture is intentionally small:

static site → JavaScript widget → Cloudflare Worker → D1

The interesting part is that the Worker and D1 database live in the site's own Cloudflare account.

So you don't need to run a VPS or use a centralized comment SaaS.

I'm mainly interested in feedback from Hugo users:

What dynamic functionality do you find yourself needing most often on otherwise-static sites?


r/gohugo • • Aug 11 '26

Dark/light syntax highlighting in Hugo without two Chroma stylesheets: a post-build tool

6 Upvotes

I built a tool that addresses a few things that come up here regularly: syntax highlighting that follows dark/light mode, theme CSS bleeding into code blocks, and hand-rolling copy-to-clipboard buttons. If you've ever generated two Chroma stylesheets and fought your theme's specificity to make dark mode work, that's the itch this scratches.

Kazari is a Go library and CLI that upgrades code blocks into framed, highlighted blocks with copy buttons, line numbers, collapsible sections, and dual light/dark themes. The dark mode part is what I think this community will care about most: both themes are baked into the HTML as CSS custom properties at build time, so switching is pure CSS. No second stylesheet, no running hugo gen chromastyles twice, no flash on toggle or page load, no JavaScript involved in the switch.

The Hugo integration needs zero changes to your theme or pipeline:
hugo --minify
kazari process ./public

kazari process walks the built HTML and rewrites the code blocks in place. Everything else on the page is untouched, and running it twice is a no-op, so it's safe as an unconditional build step. It reads Chroma's output fine and translates hl_lines to line markers. An optional one-file render hook unlocks per-block options straight from the fence (titles, marked ranges, focus lines, collapse ranges):

```go {title="main.go" mark="3-5"}```

Highlighting is done by Nuri, a pure Go port of Shiki, so you get TextMate grammars and real VS Code themes rather than Chroma's lexers, with no Node in the pipeline. Any Shiki theme name works: github-dark, dracula, catppuccin-mocha, one-dark-pro, and so on. There are 65 bundled themes, and you can browse them all side by side here: https://frostybee.github.io/kazari/docs/styling/theme-gallery/

Live example (a small Hugo site, already processed): https://frostybee.github.io/kazari/examples/hugo/

Docs and the Hugo guide: https://frostybee.github.io/kazari/

Happy to answer questions about how the HTML rewriting works.


r/gohugo • • Aug 10 '26

A Hugo module for inlining SVG icons from any Iconify set

9 Upvotes

I am sharing a Hugo module that lets you drop SVG icons into your templates and Markdown with a set of manipulation options (resize, rotate, flip, color, opacity, accessibility labels, etc.), all at build time requiring zero JavaScript.

It works with any Iconify icon set (Tabler, Heroicons, Font Awesome, Material Design, Simple Icons, and 200+ others). You use a small CLI to export only the icons you actually need as SVG files, then reference them in your templates or via a shortcode:

{{ partial "swarm-icon/icon.html" "tabler:home" }}

or in Markdown:

{{< icon "tabler:home" size="24" fill="red" >}}

Here are some characteristics of this module:
- Only the icons you export end up in your site. No icon fonts, no sprite sheets loading hundreds of unused glyphs.
- Set one dimension and the other scales from the aspect ratio, so non-square icons don't get squished.
- Decorative icons get aria-hidden/focusable="false" automatically. Add a title param and it switches to role="img" with a proper <title> element.
- If you reference an icon you forgot to export, Hugo tells you exactly which CLI command to run. No silent broken images.
- The companion CLI is a single Go binary. No Node, no npm.

There's a live demo with an interactive playground where you can mess with all the parameters: https://frostybee.github.io/hugo-swarm-icons/

Repo: https://github.com/frostybee/hugo-swarm-icons

Companion CLI: https://github.com/frostybee/go-swarm-icons

Would love to hear what you think or if you run into any issues. Happy to answer questions.


r/gohugo • • Aug 07 '26

How do I keep date in front matter as just a year (like 2023) instead of Hugo converting it to a full timestamp?

4 Upvotes

I have front matter like date: 2023 but Hugo still coerces it into a time.Time, and when there's no month/day it comes out as a garbage date like Dec 31 1969. Is there a way to keep partial dates (year only, or year+month) as plain strings, or should I just use a different field name instead of date? Hugo version: v0.162.1


r/gohugo • • Jul 30 '26

I built a simple chat CMS for Hugo sites that my clients can actually use

9 Upvotes

I built the simplest possible tool that allows clients to do small edits via chat interface eg. change phone number, update email etc. Anything risky/big comes back to you so clients can't break anything

Connect the repo and it figures out the editable content on its own. No schemas, no config files

Live demo: https://cmsbrew.com/demo


r/gohugo • • Jul 24 '26

Papermod and Sitemap

4 Upvotes

Hi everyone, I’ve been having this problem for a few days now.

Honestly, I’m not sure if it’s due to the theme I’m using or other factors.

I use Vercel, and three days ago I tried uploading the sitemap to GSC, but I keep getting a "couldn't fetch" error. The site is new; I’ve completed all the verification steps, and everything seems to be in order.

I can’t figure out what the problem is. Has anyone else experienced this issue?


r/gohugo • • Jul 17 '26

I created a Claude Code skill for building landings with Hugo

Thumbnail
github.com
12 Upvotes

r/gohugo • • Jul 16 '26

"Nerdy" a nerd-vibed Hugo theme for personal portfolio and blog.

Post image
32 Upvotes

Sharing my hugo theme with the community. Feedback are welcomed.

Live Preview: https://nerdy.hugo-themes.com/

Github Repo: https://github.com/hugo-themes/nerdy


r/gohugo • • Jul 02 '26

Where's the best place to find freelancers who could help build my new site in Hugo?

5 Upvotes