HUGO can also be cool

HUGO can also be cool

August 4, 2025

Time for a HUGO recap: the crazy fast SSG

And to make some updates to:

  1. Entreagujaypunto
  2. EnjoyLittleThings
  3. FossEngineer

Cool HUGO Themes

My favourite is still hugo-theme-gallery: https://github.com/nicokaiser/hugo-theme-gallery

I have used it for some projects:

As described here - https://jalcocert.github.io/JAlcocerT/creating-photo-centric-blog-with-hugo/

Here is my forked version of it (also MIT):

I was playing a lot with this theme to make it more accesible:

  • Via a Telegram Bot
  • With some integration with Filebrowser

It was about time to vibe code something:

git clone https://github.com/JAlcocerT/hugo-theme-gallery-flasked
cd ./hugo-theme-gallery-flasked/exampleSite

# Install Hugo module
hugo mod get

# Pull example images from Unsplash
./pull-images.sh

If your go and hugo version allows:

#hugo server
hugo server --bind="0.0.0.0" --baseURL="http://192.168.1.7" --port=1319
#hugo

HUGO Theme Gallery

make prod-build
make prod-up

isn’t it great?

I saw some people doing cool things:

Which it seems to

Flask for HugoThemeGallery

I decided to create a new branch and vibecode a little:

Flask WebAPP x HUGO Theme

See the FlaskCMS Post, where Im bringing few ways to edit live into a webapp

As I was tinkering also with the SliDevCMS Post

As per the different options described here.

I went for the EasyMDE as GPT5 mentioned is the lightest weight.

And…this thing works:

  • Edit _index.md or index.md via Flask WebApp, containerized at hugo-flaskapp
  • Build the Hugo changes (THIS IS FAST) via UI
  • Visualize your hugo changed theme live with the hugo_container or via the serve built from hugo-static-python

It’s all on the flask-hugo-gallery branch and this compose: https://github.com/JAlcocerT/hugo-theme-gallery-flasked/blob/flask-hugo-gallery/docker-compose-hugoflask.yml

git clone https://github.com/JAlcocerT/hugo-theme-gallery-flasked
#git clone -b flask-hugo-gallery --single-branch https://github.com/user/repo.git
cd hugo-theme-gallery-flasked/
git branch -a
git switch flask-hugo-gallery

And just build + spin the containers:

# Install Hugo module
hugo mod get

# Pull example images from Unsplash
./pull-images.sh

#make help

make hugoflask-build #to get go and hugo into a container
make hugoflask-up
#docker exec -it hugo-flaskapp sh

Add any photo, hit Build Hugo and you are done:

alt text

See the changes via: localhost:5050, localhost:8089, localhost:1318

Saasify Theme

HUGO Doks

I had to fork the theme:

https://github.com/JAlcocerT/hugo-doks

Which it reminds me a lot to Astro Starlight :)

See: https://docs.thulite.io/getting-started/


Conclusions

Theme Gallery + Flask

This superseeds the telegram bot thing that I plugged here to the theme as per this post

And the filebrowser + Hugo approach described here

All that people wants is a simple UI to upload images with this kind of themes.

So why not doing so via Flask?

This is my first try: https://github.com/JAlcocerT/hugo-theme-gallery-flasked

At some point…could UI be modifed via Flask as per Codex commands? Who knows…

EntreAgujayPunto Updates

EnjoyLittleThings Updates

FossEngineer Updates

PaperMod has been great.

git clone https://gitlab.com/fossengineer1/fossengineerpapermod
cd fossengineerpapermod
hugo server
# Start building sites … 
# hugo v0.108.0-a0d64a46e36dd2f503bfd5ba1a5807b900df231d linux/amd64 BuildDate=2022-12-06T13:37:56Z VendorInfo=gohugoio

#                    | EN   
# -------------------+------
#   Pages            | 228  
#   Paginator pages  |  63  
#   Non-page files   |   0  
#   Static files     | 248  
#   Processed images |   0  
#   Aliases          |  45  
#   Sitemaps         |   1  
#   Cleaned          |   0  

# Built in 759 ms

The first HUGO Theme that I tried.

But I feel like I need now something more than a blog like theme for this project.

I like the doc feeling of Hextra.

Shortcode to parse YML

I was thinking on a way to have proper mantainance of the docker-compose on the posts.

As im just one, I thought to take help from others (and also take feedback).

Some kind of general readme would be fine, like: https://github.com/rokbenko/ai-playground/tree/main

This shortcode looks into ./assets/snippets and just renders the content into the markdown post:

FossEngineer x HomeLab