New Themes Gallery site

I’ve been working on a new themes gallery site. When it is finished it will live at .

Currently the approach I’m taking is to checkout the hugo themes repo. Iterate over all of the themes in the repo and use a script to create the content pages for the gallery. The advantage of this approach is that the themesRepo will always be in sync with the themesGallery. There is also no additional overhead. Once the format is provided, it will be used in both places.
It would be great if the community could help by making sure that each theme is up to these new requirements.

Each theme needs:

  1. To be added to the themes repo
  2. The right fields in theme.toml
  3. The right images
  4. A good readme.


The following fields are required
Notice: This is different from the file created by hugo new theme in v0.12

name = "Hyde"
license = "MIT"
licenselink = ""
description = "An elegant open source and mobile first theme"
homepage = ""
tags = ["blog", "company"]
features = ["blog", ]

    name = "spf13"
    homepage = ""

# If Porting existing theme
    author =  "mdo"
    homepage = ""
    repo = ""


Thumbnail should be 900x600
Screenshot Should be 1500x1000

Media must be located in:


Additional media may be provided in that same directory.


The readme serves double purposes. It is used on github as the content for the main page. It also will become the content on the detailed theme view page for It should be markdown and called


This will be great. It’s hard to preview the themes, since many of them don’t have links to live sites or even screenshots. A few of them also seemed to use older templating language, so it’d be great to use to see the best ways to interact with the theming system.

Any timeline updates?

The site is ready to launch as soon as the themes are updated. I’d love someone to drive this home the rest of the way. I’ll commit the script which builds the entire site and hopefully someone can finish it up.

@michael_henderson… This is the thread around the themes gallery site I mentioned.

1 Like

I’ll look at this. Should I be revving the themes for 0.12 or the upcoming 0.13?

I think v0.12 for now. Perhaps suggest a v0.13 branch which is compatible with the upcoming branch. I’ll give you access to the themes repo.

@spf13, I’m not sure what do here. I can create the screenshots, but where am I storing them? The hugoThemes repo seems to be just links to external repos. Am I creating a pull request for to send to those maintainers? Or is the hugoThemes going to change to be the blessed repository for the themes? Same question on bringing an existing theme up to date.

I think sending pull requests is best.

That will be very nice to have this preview feature.

Can we maybe add a required_version (or minimum_version or something) field so that people know not to use some templates with some versions of Hugo?

I won’t be submitting cabaret until 0.13 is released because I have some dependencies on things that only exist in the latest dev versions (and there may be dependencies on things that only exist in my branches, but I’m going to try to get those accepted before 0.13 releases ;).

Any reason to use shortname tn.png for thumbnail only? IMHO, screenshot and thumbnail, both should have full name or short name only. Not mixed.

You make a good point, but I’ve already defined it in that way and developed a site expecting it. Additionally themes have already begun to comply. We could adjust the site to read either and adjust the spec. Not sure how much work that would be.

We could adjust the site to read either and adjust the spec

I haven’t seen the code so can’t comment on that part.

Only thing, I personally prefer full names from “reader” perspective. Something like:


As this is very minor thing so can be ignored for now. :slight_smile:

Excited about hugo themes gallery.

@michael_henderson now as Hugo 0.13 is out, it’s a good time to pick up the themes ball. If someone could create a list somewhere with themes and a short todo list, we could put our names in there and share the work load creating pull requests.

Before we do this, we should add a required_version, then we can set them all to 0.12 (or most of them).

I just committed this script which is intended to be used to generate the theme site.

1 Like

I have spent part of the Sunday doing extremely boring themes work:

There are some tasks left - and then a waiting game for all the pull requests to go through.

Note: By OK in the sheet, it passes a very limited set of “tests”.

I thought that I would have time when I volunteered. That’s not the case right now. I am sorry about that.

What is the status of this?

Is there any help that is needed to get this live?

There are some todo-issues here:

There were someone raising hands on Gritter saying they would look into the polish part, but since then, silence.

Thanks, I should have thought to look for the repo.