All Themes Hugo
Permalink
Failed to load latest commit information.
Shapez-Theme @ ac31bdb Update themes Nov 5, 2016
academic @ 3996b85 Update themes Jan 6, 2017
after-dark @ 9793955 Update themes Dec 26, 2016
agency @ 96b96e3 Update themes Dec 16, 2016
aglaus @ 934fd20 Update themes Oct 20, 2016
air @ 97a6454 Update themes Jun 4, 2016
allegiant @ 4db3e8f Update themes Nov 5, 2016
amp @ 6538ac6 Update themes Sep 8, 2016
angels-ladder @ bbe249f Update themes May 17, 2016
anybodyhome @ 97dab2d Update themes Nov 19, 2016
artists @ cf9ab45 Update themes Nov 5, 2016
aurora @ d760f75 Update themes: aglaus aurora hugo-icarus robust rocktopus shiori Jan 18, 2016
base16 @ ede0981 Update themes Jun 2, 2016
beautifulhugo @ ecb7e94 Update themes Apr 24, 2016
beg @ 2320d2f Update themes Oct 20, 2016
blackburn @ 43b2c93 Update themes Nov 23, 2016
blank @ ac30199 Update 10 themes: academic, blank, bleak, etc. Dec 20, 2016
bleak @ dc55b54 Updaete themes Dec 22, 2016
bootie-docs @ 0a87855 Update themes Jan 6, 2017
bootstrap @ 524039b Update 10 themes: academic, blank, bleak, etc. Dec 20, 2016
cactus @ 7252f59 Update themes Nov 19, 2016
casper @ eb63b94 Update themes Nov 8, 2016
cocoa @ ba1f3e6 Update themes Jan 6, 2017
cocoa-eh-hugo-theme @ 705af05 Update themes Jan 6, 2017
creative @ cea31c1 Update themes Nov 29, 2016
crisp @ 4ff3832 Update themes Jun 2, 2016
darksimplicity @ 4ea722c Add darksimplicity theme Jan 3, 2017
detox @ 13f8f1b Update themes Jan 6, 2017
docuapi @ d28e60b Update themes Dec 31, 2016
foundation-theme @ 87cfb0d Add foundation theme Dec 16, 2016
freelancer @ caca7d3 Update themes Nov 5, 2016
future-imperfect @ 2db677f Update themes May 17, 2016
ghostwriter @ c04abbc Update themes Jan 6, 2017
gindoro @ 6bfc86b Update to latest and greatest! Oct 5, 2015
github-project-landing-page @ 9d8a23c Adding Github-project-landing-page Dec 18, 2015
gohugo-amp @ eeb2b03 Update themes Dec 26, 2016
greyshade @ 28fb061 Update themes Jul 19, 2015
grid-side @ 8f162ae Update themes Nov 19, 2016
heather-hugo @ cb93a3b Update themes May 4, 2016
hemingway @ d7d9e3f Update themes Nov 11, 2016
herring-cove @ 9deb5b4 Update themes Nov 19, 2016
highlights @ bf264f2 Update themes Nov 29, 2016
hikari @ f0286d3 Update themes Nov 5, 2016
hpstr-hugo-theme @ cd4792a Update themes Nov 23, 2016
html5 @ 2ba91ef Update themes Dec 31, 2016
hugo-alabaster-theme @ 8fa6214 Update themes Nov 5, 2016
hugo-base-theme @ 743ff64 Update themes Nov 5, 2016
hugo-bootstrap-premium @ d7394f0 Update themes Dec 7, 2016
hugo-bootswatch @ 4367ac1 Update themes Apr 24, 2016
hugo-creative-portfolio-theme @ 18a3cc1 Update themes Dec 31, 2016
hugo-darkdoc-theme @ 4edd431 Update themes Nov 29, 2016
hugo-dgraph-theme @ 6014da7 Update themes Nov 5, 2016
hugo-elate-theme @ bfe84e7 Update themes Dec 26, 2016
hugo-faq-theme @ e6ed082 Update themes Oct 20, 2016
hugo-finite @ 34cecdc Add hugo-finite theme Sep 2, 2016
hugo-frais @ 282ffa6 Update themes Nov 19, 2016
hugo-geo @ 268930e Update themes Dec 31, 2016
hugo-goa @ a1142ac Update themes Nov 29, 2016
hugo-h5bp @ 7741bbc Update themes Aug 6, 2015
hugo-hello-programmer-theme @ 2936071 Update themes Dec 4, 2016
hugo-icarus @ 9e2010b Update themes Jan 6, 2017
hugo-identity-theme @ 4a39f11 Update themes Oct 20, 2016
hugo-incorporated @ 633cae6 Update themes Sep 27, 2016
hugo-lithium-theme @ 7be4c45 Update themes Nov 19, 2016
hugo-mdl @ a343c71 Update themes Sep 27, 2016
hugo-me-theme @ 6f47ca9 Update themes Oct 20, 2016
hugo-minimalist @ 7be8676 Update themes Jan 6, 2017
hugo-multi-bootswatch @ ffd972e Update themes Nov 19, 2016
hugo-octopress @ de3a76b Update themes Nov 16, 2016
hugo-orbit-theme @ 16e9542 Update themes Oct 20, 2016
hugo-pacman-theme @ 0a6aadd Update themes Nov 19, 2016
hugo-paper-now @ 8c8134c Add paper-now theme Dec 18, 2016
hugo-phlat-theme @ 8f5e26f Update themes Nov 19, 2016
hugo-plus @ bba9290 Update themes Feb 17, 2016
hugo-remark-minion @ 3377e99 Add remark-minio theme Dec 26, 2016
hugo-remark-twemoji @ fa6d586 Add remark-twemoji theme Dec 31, 2016
hugo-smpl-theme @ aa4bdc1 Updaete themes Dec 22, 2016
hugo-sp-minimal @ 2f3feb8 Add sp-minimal theme Nov 16, 2016
hugo-sustain @ e765629 Update remote url for sustain them Jan 6, 2017
hugo-theme-arch @ 6fedcdc Update themes Nov 19, 2016
hugo-theme-bootstrap4-blog @ af39372 Update themes Jan 6, 2017
hugo-theme-foundation6-blog @ 2f64128 Update themes Jan 6, 2017
hugo-theme-geppaku @ 06a5148 Update themes Jan 6, 2017
hugo-theme-learn @ 7603122 Update themes Dec 31, 2016
hugo-theme-nix @ 294fb7f Update themes Dec 7, 2016
hugo-theme-vec @ d99467d Update themes Nov 19, 2016
hugo-theme-wave @ edb7980 Update themes Nov 19, 2016
hugo-tranquilpeak-theme @ 6e39afc Update themes Dec 16, 2016
hugo-universal-theme @ 58cd73d Update themes Nov 5, 2016
hugo-uno @ 11fb326 Update themes Jul 26, 2016
hugo-zen @ 924fceb Update themes Nov 5, 2016
hugo_eiio @ f5d1236 Update themes Dec 16, 2016
hugo_theme_solit @ 939d692 Update themes Oct 20, 2016
hugoscroll @ 6f6ce41 Update themes: aglaus artists crisp hugoscroll robust Jan 7, 2016
hugrid @ 52446a9 Update themes Oct 20, 2016
hurock @ 13081b8 Update themes Apr 12, 2016
hyde @ d34cfef Update themes Nov 19, 2016
hyde-x @ ee61d83 Update themes Mar 7, 2016
hyde-y @ c12d7ed Update themes Nov 23, 2016
internet-weblog @ 69c0730 Update themes Jan 6, 2017
journal @ e543e4b Update themes to latest and shiniest Nov 7, 2015
landing-page-hugo @ 4d80b5b Update themes Sep 8, 2016
lanyon @ 0c3da68 Update themes Apr 27, 2016
light-hugo @ b984f79 Update themes Nov 16, 2016
liquorice @ 901ad23 Update themes Nov 19, 2016
lunancy @ 48f752d Update themes Sep 30, 2016
mainroad @ c7dccc8 Update themes Jan 6, 2017
martial-paper @ c099808 Update themes Oct 23, 2016
material-design @ 587b3af Update themes Sep 2, 2016
material-docs @ 194c497 Update themes Dec 31, 2016
material-lite @ 24a23e3 Update themes Dec 2, 2015
mtl-pure @ 9564ef1 Update themes Nov 29, 2016
next @ ce71ee2 Update themes Jun 23, 2016
nixon @ 142e0a6 Update 10 themes: academic, blank, bleak, etc. Dec 20, 2016
nofancy @ c1113e8 Update themes Nov 29, 2016
paperback @ 5343d39 Add paperback theme Aug 10, 2016
persona @ afb2d45 Add persona Jun 15, 2015
phugo @ f86dacf Update themes Oct 23, 2016
pixyll @ 50dad69 Update themes Jan 15, 2016
polymer @ d8be002 Add polymer Jun 30, 2015
projecthub @ d0fb856 Add projecthub Jul 29, 2015
purehugo @ 06811c8 Update themes Aug 10, 2016
redlounge @ 9f5fa6c Update themes Nov 23, 2016
robust @ 3baae29 Update themes Oct 20, 2016
rocktopus @ c47bcd7 Update themes Feb 17, 2016
shiori @ e23d4a1 Update themes Feb 17, 2016
simple-a @ 6c3ae9c Updaete themes Dec 22, 2016
simple-hugo @ b5adcb7 Update themes Nov 19, 2016
slender @ 1ecf67e Add slender theme Nov 16, 2016
slim @ 2545a0c Update themes Nov 23, 2016
startbootstrap-clean-blog @ 4d50332 Update themes Nov 23, 2016
steam @ 2424b5e Update themes Dec 16, 2016
strange-case @ 5f4589f Add strage-case theme Sep 2, 2016
strata @ 7ebb33a Update themes Nov 19, 2016
tachyons @ a98c649 Update themes Jul 19, 2015
tinyce @ 5ffc8f5 Update themes Dec 7, 2016
twentyfourteen @ 83f0a78 Update themes May 17, 2016
type @ cfcad2a Update themes Dec 31, 2016
vienna @ 890e97c Update themes Jul 24, 2015
would-have-been-cool-in-the-80s @ 7933ce7 Update themes Oct 23, 2016
yume @ 9ba729a Add yume theme (again) Dec 4, 2016
.gitmodules Update remote url for sustain them Jan 6, 2017
LICENSE Initial commit May 23, 2014
README.md Mention "update cycle" Dec 18, 2016

README.md

Hugo themes

A collection of all themes that were created by the Hugo community. See a complete listing of all of these themes along with screenshots and demos at themes.gohugo.io. Every theme in this list will automatically be added to the theme site. Theme updates aren't scheduled but usually happen at least once a week.

Build script

For the curious, here's how this automatic adding is accomplished.

Installation

Installing all themes

If you would like to install all of the available Hugo themes, simply clone the entire repository from within your working directory with this command:

git clone --depth 1 --recursive https://github.com/spf13/hugoThemes.git themes

Installing a single theme

cd themes
git clone URL_TO_THEME

Adding a theme to the list

  • Create your theme using hugo new theme THEMENAME;
  • Test your theme against https://github.com/spf13/HugoBasicExample;
  • Add a theme.toml file to the root of the theme and add some metadata about the theme;
  • Add a descriptive README.md to the root of the theme;
  • Add /images/screenshot.png and /images/tn.png (see below);
  • Open up a new Issue with a link to the theme's repository on GitHub.

If your theme doesn't fit into the Hugo Basic Example site, we encourage theme authors to supply a self-contained Hugo site in /exampleSite.

NOTE: The folder name here is important, as this folder will be picked up and used by the script that generates the Hugo Theme Site. It mirrors the root directory of a Hugo website and allows you to add custom content, assets and a config file with preset values.

See Artist theme's exampleSite for a good example. And please make the site's content as neutral as possible.

Each theme needs:

  1. To be added to the hugoThemes repo;
  2. To have the right fields in theme.toml;
  3. To have the right images; and
  4. A good README.

theme.toml

This file contains metadata about the theme and its creator. The following fields are required:

name = "Hyde"
license = "MIT"
licenselink = "https://github.com/spf13/hyde/blob/master/LICENSE.md"
description = "An elegant open source and mobile first theme"
homepage = "http://siteforthistheme.com/"
tags = ["blog", "company"]
features = ["blog", ]
min_version = 0.13

[author]
    name = "spf13"
    homepage = "http://spf13.com/"

# If porting an existing theme
[original]
    author = "mdo"
    homepage = "http://hyde.getpoole.com/"
    repo = "https://www.github.com/mdo/hyde"

Notes:

  1. This is different from the file created by hugo new theme in the old v0.12. The current Hugo v0.13 does create the same template with the new fields except min_version that was added in 0.14-DEV.

  2. Only theme.toml is accepted, not theme.yaml or not theme.json.

Media

Screenshots are used as preview in the list. Make sure that they have the right 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.

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.