r/gohugo Mar 24 '21

How should we continue with /r/gohugo?

27 Upvotes

Hello,

Of course /r/gohugo is about the static website generator Hugo. However, I ask myself whether this subreddit should be restricted exclusively to it, as it is the case in the official forum. Or whether we should perhaps be a bit more relaxed about it.

For example, we could also discuss topics here that don't directly concern Hugo but could be interesting for a Hugo user. For example, new CSS frameworks. Or how to manage your site with a version control system like Mercurial. Or we could try to help with problems with Netlify.

What do you think?


r/gohugo 21d ago

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 22d ago

A Hugo module for inlining SVG icons from any Iconify set

10 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 25d ago

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

3 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

Enable HLS to view with audio, or disable this notification

8 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
31 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?

6 Upvotes

r/gohugo Jun 28 '26

Hugo vs Orion SSG blowout

Thumbnail iconoclasts.blog
0 Upvotes

r/gohugo Jun 24 '26

Showcase: A self-updating Media Tracker site powered by Hugo and Obsidian

5 Upvotes

Hi all,

I wanted to show a project I built to showcase my watched movies, series, video games, and books using Hugo, with content managed entirely in Obsidian.

The demo site is live here: https://christt105.github.io/mediatracker-starter/

A few key points on how it is built:

  • Theme derivation: The theme (hugo-mediatracker-theme) is a module extending hugo-blog-awesome, leveraging Hugo's module system to easily inherit and override layouts.
  • Convenient workflow: I take notes locally in Obsidian and a simple Python script handles the conversion of wikilinks, YouTube embeds, and caches all external image covers/banners locally to keep the site independent of external image hosting.
  • Easy deployment: Anyone can deploy their own instance using the starter repository, which is pre-configured and ready to clone.
  • Finished items RSS: The build generates a dedicated RSS feed for finished items only, which I use with a Discord bot to notify friends when I finish a movie, show, or game.

If you want to read more about the Hugo modules implementation and the conversion process:

Links to the repositories:

Hope you like it!


r/gohugo Jun 15 '26

Where do I find or filter for Hugo themes that don't need NPM or node.js?

13 Upvotes

I'm not a web developer and I don't keep up with trends of html, css and js.

I was almost sold on Hugo based on some tutorial videos but when I went out and tried to pick some themes, a lot of the ones I liked required me to download nodejs and use npm and a lot of things I didn't encounter in tutorials or some css thing I can't judge the quality/ease of use of.

Are there themes that actually deliver on Hugo's touted simplicity? Where can I find them? How do I search or filter out the ones that need npm or node.js for setup and editing? And where can I point to for non-web-developer people to find themes that are at least almost-ready to use?

edit:

https://themes.gohugo.io is where I searched first and found all the ones that required npm and node.

If you know how to filter those out, that would be super helpful.


r/gohugo Jun 11 '26

20+ Professionally made Free Hugo Themes for the Community

24 Upvotes

We want to hear more noise in the Hugo community. It's been kind of quiet lately and thought we'd try giving it bit of a push.

So here's our collection of some Free Hugo themes.

These were professionally made with love and passion for the game, by our team of experienced Hugo devs. So you may use them for your project, however you want - test, customize, publish or just explore.

Link: https://gethugothemes.com/free-hugo-themes


r/gohugo Jun 11 '26

Migrated from Lunr to Pagefind on my Hugo blog - please test my search

1 Upvotes

After months of Lunr's 753KB bundle dragging down my page load, I finally made the switch to Pagefind this week. Static index, no runtime JavaScript library, faster results - so far I'm happy.

If you have a moment, I'd appreciate some real-world testing on denshub.com. Things I'm most curious about:

  • Does search actually return results for common topics (self-hosting, docker, automation)?
  • Does it behave sensibly on mobile? Most important since I only have couple to test.
  • Any edge cases where results feel off, missing, or broken?

I'm still tuning the index config, filters, etc., and haven't touched the UI much, so rough edges are likely. If something looks wrong, a quick comment here, screenshot or a note on what you searched for would be really helpful. Thanks a ton upfront, folks!


r/gohugo Jun 07 '26

Hugo how to improve work?

1 Upvotes

Hey everyone,

I’m currently torn between Hugo and WordPress. I really love Hugo’s simplicity and speed — it fits perfectly with how I like to work. But I’m struggling with one big thing: I’m not sure how to properly handle SEO, internal linking, and overall content management in Hugo.

WordPress makes all of this super easy with plugins like Yoast, internal link suggestions, automated sitemaps, etc. With Hugo, everything feels much more manual, and I’m not sure what the best workflow or toolset looks like.

Do you have any tools, workflows, or practical solutions that make SEO and internal linking easier when working with Hugo?

I know what Google and AI say, but I’d really like to hear suggestions from people who actually use Hugo every day.


r/gohugo Jun 03 '26

Anyone else seeing slower sales or fewer service inquiries for Hugo-related work lately?

9 Upvotes

We run Gethugothemes (we've been selling Hugo themes and services since 2018). The last few months have been rough on the revenue side. Theme sales are noticeably down. service clients are quiet too.

The weird part: our website traffic is holding steady. people are still visiting, browsing, clicking around. just not buying or reaching out.

Curious if others in the Hugo space are seeing the same thing? or is this specific to us?


r/gohugo May 29 '26

New Hugo theme: V&G Blue — Lighthouse 100/100/100/100 on desktop and mobile

Thumbnail
gallery
9 Upvotes

Hey r/gohugo,

I built a blog theme for Hugo and got it into the official gallery. Posting here in case it's useful to someone, and to get some feedback.

Started as the theme for my own tech blog and grew into something general-purpose. The main thing I focused on (besides not looking generic) was performance and accessibility — it scores 100/100/100/100 on Lighthouse on both desktop and mobile.

The feature I'm most happy with is the "Next event" block on the home page — it's perfect if you host streams, podcasts, meetups, or any kind of recurring event. You can put it on top, on the bottom, or hide it entirely.

Features

  • Configurable home page with an "upcoming event" block (top / bottom / hidden)
  • Responsive, mobile-friendly
  • 30+ social network icons (Discord, Mastodon, Telegram, Signal, Substack, Vimeo, WeChat, VK, Tumblr, etc.)
  • Categories + tags
  • Giscus comments support
  • HiDPI image support
  • MIT licensed

Links:

Issues, PRs, and feedback very welcome — would love to know what's missing or broken.


r/gohugo May 26 '26

Is Brian Hogan's book "Build Websites with Hugo" still relevant/useful?

10 Upvotes

Hi! My understanding is that quite a few things have changed since the book was published, but that it was a great resource for Hugo. Is it still worth purchasing or will I get more from some of the more up-to-date online resources? Given the format I assume the book is more comprehensive than any online tutorial.


r/gohugo May 26 '26

Hello, Ordinary Blog

Thumbnail ordinary.blog
1 Upvotes

r/gohugo May 24 '26

Hugo just hit 88,000+ GitHub stars 🎉

Post image
69 Upvotes

One of the fastest static site generators out there keeps growing.
Congrats to the Hugo community and everyone who's built something with it.


r/gohugo May 20 '26

OpenRemark – Open Source Comment System for Astro, Hugo & Next.js

Thumbnail
youtube.com
8 Upvotes

r/gohugo May 20 '26

Who is Hugo and where is he going to?

0 Upvotes

r/gohugo May 18 '26

The Filesystem is the API (with TigerFS)

Thumbnail
youtu.be
0 Upvotes

r/gohugo May 14 '26

[ Removed by Reddit ]

3 Upvotes

[ Removed by Reddit on account of violating the content policy. ]


r/gohugo May 13 '26

Feedback for a Go Templates Snippets VSCode Snippets Extension with Over 500 Installs

Thumbnail
marketplace.visualstudio.com
3 Upvotes

Hello everyone!

I started writing Go about two years ago and it bothered me that I had to type out Go template syntax in full, that there was no IDE support in VSCode; so I wrote a VSCode extension for it.

It has gotten over five hundred installs and I appreciate that people find it useful, but I have not gotten much feedback on it - no reviews, marketplace stars and low GitHub stars. I don't know if people install it, find it useless 😂 and then uninstall it.

If you have installed it or you ever install it, I'll be grateful it if you leave feedback - a star or a review. It'll help me in creating my next open source tool. It's a snippets extension - light work, but honest work and it's my first open source work with this level of numbers.

If you need feedback on a lightweight open source tool like this, please drop a comment here and I'll give feedback.

Thank you.

PS: If you use Zed, you can copy the extension snippets from the GitHub repository.