A collection of themes created by the Hugo community

Overview

Hugo themes

A collection of themes created by the Hugo community. Builds to themes.gohugo.io.

Having questions? Have a look at the FAQ first.

Netlify Status

Adding a theme to the list

  • Create your theme using hugo new theme THEMENAME;
  • Add a config.toml with supported Hugo version(s) and theme.toml file to the root of the theme and add some metadata about the theme (see below);
  • Add a descriptive README.md to the root of the theme;
  • Add /images/screenshot.png and /images/tn.png (see below);
  • Add your theme path (e.g. github.com/gohugoio/gohugoioTheme) to themes.txt in lexicographical order.
  • Create a Pull Request and verify that the preview looks good.

Theme Configuration

You should have a file named theme.toml in the root of your theme. This file contains metadata about the theme and its creator or creators. Only theme.toml is accepted, not theme.yaml or not theme.json.

name = "Theme Name"
license = "MIT"
licenselink = "Link to theme's license"
description = "Theme description"

# The home page of the theme, where the source can be found.
homepage = "https://github.com/gohugoio/gohugoioTheme"

# If you have a running demo of the theme.
demosite = "https://gohugo.io"

tags = ["blog", "company"]
features = ["some", "awesome", "features"]

# If the theme has multiple authors
authors = [
  {name = "Name of author", homepage = "Website of author"},
  {name = "Name of author", homepage = "Website of author"}
]

# If the theme has a single author
[author]
    name = "Your name"
    homepage = "Your website"

# If porting an existing theme
[original]
    author = "Name of original author"
    homepage = "His/Her website"
    repo = "Link to source code of original theme"

Your theme should also have a configuration file (e.g. config.toml) configuring what Hugo versions the theme supports:

[module]
  [module.hugoVersion]
    extended = true
    min = "0.55.0"
    max = "0.84.2"

Note that you can ommit any of the fields extended, min or max.

LICENSE

Themes in this repository are accepted only if they come with an Open Source license, that allows for the theme to be freely used, modified, and shared.

To have a look at popular licenses please visit the Open Source Initiative website.

Note: When porting an existing theme from another platform to Hugo, or if you are forking another Hugo theme in order to add new features and you wish to submit the derivative work for inclusion at the Hugo Themes Showcase, you really need to make sure that the requirements of the original theme's license are met.

If a submission is found to violate the LICENSE of an original theme, it will be rejected without further discussion.

Media

Screenshots are used as theme previews in the list, they should feature a theme's layout (without any browser chrome or device mockups) and have the following dimensions:

  • Thumbnail should be 900×600 in pixels
  • Screenshot should be 1500×1000 in pixels
  • Media must be located in:
    • [ThemeDir]/images/screenshot.png
    • [ThemeDir]/images/tn.png

Additional media may be provided in that same directory.

README.md

Your theme's README file (which should be written in Markdown and called README.md) serves a double purpose. This is because its content will appear in two places—i.e., it will appear:

  1. On your theme's details page at themes.gohugo.io; and
  2. At GitHub (as usual), on your theme's regular main page.

To ease accessibility for international users of your theme please provide at least an English translation of the README.

Note: If you add screenshots to the README please make use of absolute file paths instead of relative ones like /images/screenshot.png. Relative paths work great on GitHub but they don't correspond to the directory structure of themes.gohugo.io. Therefore, browsers will not be able to display screenshots on the theme site under the given (relative) path.

FAQ

Question: My theme flagged as 'old' when it's been updated recently.

Answer: We use Hugo Modules to manage the themes -- which is backed by Go Modules. If you have one or more tagged releases (e.g. v1.0.0), we will choose the last version within the current major version. To get rid of that warning you need to tag a new release and wait for us to rebuild the theme site. Note that for unversioned themes, the latest commit gets picked.

Comments
  • Update 4 Zerostatic themes

    Update 4 Zerostatic themes

    Hi, I've updated 4 themes. I've checked over each theme and made the required changes to the theme.toml, config.toml, images and also double checked each theme is still running on the latest version of Hugo.

    opened by JugglerX 10
  • Add theme Icarus-Lite

    Add theme Icarus-Lite

    Hi Mr. bep, I noticed your comment under my previous PR, and here is my new PR.

    Hope this one will work. Thank you ; )


    Theme repo: https://github.com/airinghost/hugo-theme-icarus-lite

    Theme demo: https://icarus-lite.zhangjet.com & https://zhangjet.com

    opened by airinghost 5
  • Question: Do actual screenshot dimensions matter as long as we maintain the aspect ratio?

    Question: Do actual screenshot dimensions matter as long as we maintain the aspect ratio?

    According to the README:

    • Thumbnail should be 900×600 in pixels
    • Screenshot should be 1500×1000 in pixels

    Do these exact dimensions actually matter if we maintain the aspect ratio? Say if we wanted to do something like 1260x850 instead of 900x600?

    opened by abrahamparayil 5
  • How are themes sorted on themes.gohugo.io ?

    How are themes sorted on themes.gohugo.io ?

    In searching for a new theme for a site, the first three rows (presently) have two themes that haven't seen an update in over a year while several which have seen updates in the past week are stuffed at the bottom. It's clear they're not sorted alphabetically, so what criteria is being used to sort these themes? If I'm a user looking for a theme, I'd rather focus my searches on those which seem to be active projects rather than wading my way through 100+ themes that haven't been touched in a year.

    opened by chipzoller 4
  • Cache invalidation?

    Cache invalidation?

    I noticed that the GitHub Stars count on themes.gohugo.io is not up to date (because the data cache file is 2 months old).

    Next to the Updated date (which is up to date), I think the (most recent) number of stars is a significant indicator (for popularity).

    How often does the cache get cleared?

    opened by h-enk 4
  • Added new theme : Bookworm

    Added new theme : Bookworm

    Hi,

    I am creating this PR one more time because last time it says images/tn.png is missing, but the tn.png and the screenshot.png were there in the images/ folder and in the perfect size and format. don't know why it says it is missing. But still, I have created those images one more time and creating this PR. hope it will build perfectly.

    opened by tfsomrat 4
  • Add search feature

    Add search feature

    I was looking for a theme I had seen beginning with letter T and it took a while to browse through all the themes. Kindly add a search featue to check themes by titles.

    opened by rbn30117 3
  • Remove Themefisher from this directory for spam and unethical behaviour

    Remove Themefisher from this directory for spam and unethical behaviour

    Themefisher has a long history of being a bad actor in the Hugo community. They are a premium theme company that is mostly interested in abusing open source channels to promote paid offerings.

    They have been banned on the Hugo themes directory in the past for bait and switching their free offerings with commercial ones https://github.com/gohugoio/hugoThemes/pull/760. They continue to sully the Hugo open source projects brand with their usage of Hugo in their brand names and commercial sites such as gethugothemes.com

    Now they have been found to be completely copying another open source project www.jamstackthemes.dev. They have literally copied the site code verbatim, removed the original attribution in the MIT License, deleted the git history history and re-branded the site as their own. they have launched the rebranded site at www.statichunt.com except it now contains all of their own themes at the top...

    The lack of action in the past has emboldened the owner of this company to do what they wish with the Hugo brand and they have intensified their spam and grifting activities (probably because its working and they are getting sales and nobody is saying anything).

    I suggest that all themes by Themefisher, Gethugothemes and Statichunt are removed from this directory.

    I am the core maintainer of www.jamstackthemes.dev and I am very unhappy. I realise you may not wish to involve yourself, but I am asking for your support to pressure this person into taking down their site. The removal of their themes from this official Hugo theme directory would be a significant blow to their traffic (and profits) and in my mind it is completely justified.

    @bep @digitalcraftsman

    opened by JugglerX 3
  • :new: :art: themes: Add UNICEF Inventory theme

    :new: :art: themes: Add UNICEF Inventory theme

    This commit adds a new entry for the UNICEF Inventory theme, used for a knowledge-base static site for knowledge-transfer use cases at the UNICEF Office of Innovation.

    opened by jwflory 2
Owner
GoHugo.io
A Fast and Flexible Static Site Generator built with love in GoLang
GoHugo.io
Vela plugin designed for generating a static documentation website with Hugo.

Vela plugin designed for generating a static documentation website with Hugo.

Vela 0 Jul 22, 2022
Community system build using GoFrame.

Focus聚焦社区是GoFrame社区项目,采用了简洁强大的GoFrame作为后端WEB框架, 由于前台系统需要SEO因此使用了GF自带template模板引擎,数据库用MySQL,前端使用jQuery/bootstrap框架。

GoFrame 104 Aug 3, 2022
Fully serverless CAPTCHA API created with API Gateway, Lambda, Dynamodb and Go

Fully serverless CAPTCHA API created with API Gateway, Lambda, Dynamodb and Go

Brad 1 Mar 4, 2022
E-commerce-project - RESTFUL API for TakTuku an E-Commerce App created for the purpose of study

About The Project RESTFUL API for TakTuku an E-Commerce App created for the purp

Muhamad Hilmi Hibatullah 2 Jul 23, 2022
This codebase was created to demonstrate a fully fledged fullstack application built with Golang/Echo including CRUD operations, authentication, routing, pagination, and more.

This codebase was created to demonstrate a fully fledged fullstack application built with Golang/Echo including CRUD operations, authentication, routing, pagination, and more.

Nayef Haidir 2 Mar 22, 2022
Collection of tools to interact with Intigriti website

Small tool, written in Go, that constantly monitors Activity feed on https://app.intigriti.com Dashboard page and sends Slack/Discord notifications on

null 11 Jun 27, 2022
A simple web library collection based fasthttp

A simple web library collection based fasthttp

snowmerak 17 Aug 17, 2022
A collection of themes created by the Hugo community

Hugo themes A collection of themes created by the Hugo community. Builds to themes.gohugo.io. Having questions? Have a look at the FAQ first. Adding a

GoHugo.io 127 Sep 12, 2022
Community edition nuclei templates, a simple tool that allows you to organize all the Nuclei templates offered by the community in one place

cent Community edition nuclei templates, a simple tool that allows you to organize all the Nuclei templates offered by the community in one place Inst

null 361 Sep 15, 2022
This is a community upload of a community project.

This is a community upload of a community project. The amount of people who worked on it is innumerous, and hard to keep track of. But id like to contribute this to the efforts of Ando, Fists Team, the French Team, Mai's Team and the many wondeful members of the MHFZ community who gave their time and energy to help us. No matter the relations, these files will remain public and open source, free for all to use and modify.

null 36 Sep 3, 2022
Generate a TwitterCard(OGP) image for your Hugo posts.

Twitter Card Image Generator Generate Twitter card (OGP) images for your blog posts. Supported front-matters are title, author, categories, tags, and

Aya Igarashi 137 Sep 8, 2022
Hugo-to-Gemini Markdown converter

Hugo-to-Gemini converter This repo holds a converter of Hugo Markdown posts to text/gemini (also named Gemtext in this README). The converter is suppo

Timur Demin 18 Jun 21, 2022
simple GitHub action to parse Markdown Links into a .yaml file for Hugo

Obsidian Link Scrapper Used by Quartz This repository comes to you in two parts. GitHub Action (scrapes links into a .yml file) Hugo Partial (turns .y

Jacky Zhao 68 Sep 21, 2022
Vela plugin designed for generating a static documentation website with Hugo.

Vela plugin designed for generating a static documentation website with Hugo.

Vela 0 Jul 22, 2022
expose controller, when deployment created service and ingress will be created

expose-controller expose controller, when deployment created service and ingress will be created How to test git clone repository cd expose-controller

Kanhaiya Lal Yadav 0 Dec 23, 2021
The Official Twilio SendGrid Led, Community Driven Golang API Library

NEW: Subscribe to email notifications for releases and breaking changes. The default branch name for this repository has been changed to main as of 07

Twilio SendGrid 844 Sep 18, 2022
Community system build using GoFrame.

Focus聚焦社区是GoFrame社区项目,采用了简洁强大的GoFrame作为后端WEB框架, 由于前台系统需要SEO因此使用了GF自带template模板引擎,数据库用MySQL,前端使用jQuery/bootstrap框架。

GoFrame 104 Aug 3, 2022
DeepValueNetwork is a peer-to-peer database network managed and hosted by its community.

DeepValueNetwork To understand what DeepValueNetwork will be, I suggest you read this document. In progress This software is currently being developed

DeepValue Network 337 Sep 15, 2022
community search engine

Lieu an alternative search engine Created in response to the environs of apathy concerning the use of hypertext search and discovery.

Alexander Cobleigh 155 Sep 21, 2022
A reference for the Go community that covers the fundamentals of writing clean code and discusses concrete refactoring examples specific to Go.

A reference for the Go community that covers the fundamentals of writing clean code and discusses concrete refactoring examples specific to Go.

Lasse Martin Jakobsen 2.3k Sep 23, 2022