Shell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Extend theme submission issue template Aug 9, 2018
BeyondNothing @ d6f7ff7 Add beyondnothing theme Jun 8, 2018
BluestNight @ ea6daae Update themes Jul 4, 2018
Shapez-Theme @ df6b41e Update themes Apr 16, 2017
_script Revert "Apply temporary workaround to generateThemeSite.sh" Aug 11, 2018
academic @ 74a9bb3 Update themes Aug 15, 2018
aerial @ 69cea49 Update themes Sep 14, 2017
after-dark @ c05351d Update themes Aug 15, 2018
agency @ 90e7bf0 Update themes Apr 18, 2018
aglaus @ 5c82624 Update themes Jul 4, 2018
air @ d45e1ef =Update themes Mar 25, 2018
airspace-hugo @ 5b301a1 Update themes Jul 16, 2018
allegiant @ 4db3e8f Update themes Nov 5, 2016
alpha-church @ 8369974 Update themes Aug 15, 2018
amp @ c28e332 Update themes Jun 11, 2017
angels-ladder @ bbe249f Update themes May 17, 2016
anybodyhome @ 1366760 Update themes Apr 11, 2018
apricot-hugo-theme @ 7d5e488 Update themes May 12, 2018
artists @ 2873e52 Update themes Apr 9, 2017
aurora @ d760f75 Update themes: aglaus aurora hugo-icarus robust rocktopus shiori Jan 18, 2016
base16 @ 7b2da73 Update themes Apr 5, 2018
beautifulhugo @ e78f3c8 Update themes Apr 18, 2018
beg @ 7a97382 Update themes Jul 4, 2018
bilberry-hugo-theme @ 10655a4 Update themes Aug 15, 2018
black-and-light @ 4f038b8 Update themes Aug 8, 2018
blackburn @ 1bd3b1a Update themes Apr 11, 2018
blank @ 2f15456 Update themes Sep 28, 2017
bleak @ ad16467 Update themes Jul 4, 2018
bootie-docs @ e8c7391 Update themes Apr 11, 2018
bootstrap @ 4a7fb5a Update themes Nov 12, 2017
bulma @ 1ed120d Update themes Jul 16, 2018
cactus @ 28cb664 Update themes Oct 26, 2017
capsule @ 161d41e Update themes Aug 2, 2018
casper @ ada13e0 Update themes Feb 8, 2018
castanet @ b986bc7 Update themes Aug 9, 2018
classless-hugo @ 1dc958e Update themes Apr 18, 2018
cocoa @ 9592a80 Update themes Jul 4, 2018
cocoa-eh-hugo-theme @ 1fa9afa Update themes Aug 15, 2018
crab @ 50f2090 Update themes Sep 1, 2017
creative @ cea31c1 Update themes Nov 29, 2016
crisp @ 30cc264 Update themes Nov 12, 2017
cstate @ 9554d95 Update themes Aug 15, 2018
darksimplicity @ 688b876 Update themes Aug 2, 2018
detox @ afb1e63 Update themes Feb 1, 2017
dimension @ e9cc1af Update themes Sep 19, 2017
docdock @ b667496 Update themes May 1, 2018
docuapi @ c43dd09 Update themes Feb 14, 2018
elephants @ 2e3786c Add elephants theme Jan 10, 2018
engimo @ 4afc203 Add engimo theme Aug 1, 2018
er @ 9911241 Update themes Jun 5, 2018
forty @ 464e165 Update themes Jul 4, 2018
foundation-theme @ 730ca9a Update themes May 29, 2018
freelancer @ caca7d3 Update themes Nov 5, 2016
future-imperfect @ 020882f Update themes Mar 7, 2018
ghostwriter @ 2340a01 Update themes May 29, 2018
gindoro @ 6bfc86b Update to latest and greatest! Oct 5, 2015
github-project-landing-page @ b639b77 Update themes Jul 27, 2017
gohugo-amp @ 7b77305 Update themes Apr 25, 2017
gohugo-theme-ananke @ 8c1280c Update themes Jul 16, 2018
greyshade @ 28fb061 Update themes Jul 19, 2015
grid-side @ f5251bf Update themes Jun 29, 2017
heather-hugo @ 4b4fea0 Update themes Feb 16, 2017
hemingway @ d7d9e3f Update themes Nov 11, 2016
hemingway2 @ c66fd32 Update themes Jul 31, 2017
herring-cove @ 4d435ff Update themes Apr 9, 2017
hestia-pure @ 320c944 =Update themes Mar 22, 2018
highlights @ 4823854 Update themes Mar 13, 2018
hikari @ 6475c81 Update themes Sep 10, 2017
hpstr-hugo-theme @ 3658a0b Update themes Jul 4, 2018
html5 @ 368de31 Update themes Dec 21, 2017
hucore @ 40e4b02 Update themes Jul 3, 2017
hugo-alabaster-theme @ 3510ef2 Update themes Apr 9, 2017
hugo-bare-min-theme @ 131b2fc Update themes Aug 11, 2018
hugo-base-theme @ 743ff64 Update themes Nov 5, 2016
hugo-bingo @ 7205edb Add Bingo theme Jul 23, 2018
hugo-bootstrap @ f744a34 Update themes Jul 8, 2018
hugo-bootstrap-premium @ 0795c14 Update themes Aug 8, 2018
hugo-bootswatch @ 4367ac1 Update themes Apr 24, 2016
hugo-casper-two @ b747d89 Update themes Feb 8, 2018
hugo-classic @ b0ea3b5 Update themes Jun 13, 2018
hugo-code-editor-theme @ c2b9f75 Update themes Mar 30, 2018
hugo-coder @ 1d8e193 Update themes Aug 2, 2018
hugo-conference @ 911c946 Update themes Feb 8, 2018
hugo-creative-portfolio-theme @ 41d33d5 Update themes Jun 5, 2018
hugo-darkdoc-theme @ 4edd431 Update themes Nov 29, 2016
hugo-dgraph-theme @ d783dfd Update themes Dec 21, 2017
hugo-dream-plus @ 8e8f186 Update themes Aug 15, 2018
hugo-dusk @ 9eaf09e Update themes Nov 25, 2017
hugo-elate-theme @ ccc5bfa =Update themes Mar 25, 2018
hugo-fabric @ bef8762 Update themes Oct 10, 2017
hugo-faq-theme @ e6ed082 Update themes Oct 20, 2016
hugo-finite @ 34cecdc Add hugo-finite theme Sep 2, 2016
hugo-frais @ 0425bf9 Update themes Mar 30, 2018
hugo-fresh @ 00d1368 Update themes Aug 15, 2018
hugo-gentoo-theme @ 42b5dd7 Update themes Nov 22, 2017
hugo-geo @ b91ad6f Update themes Apr 25, 2017
hugo-goa @ d7a47bd Update themes Mar 30, 2018
hugo-h5bp @ 7741bbc Update themes Aug 6, 2015
hugo-hello-programmer-theme @ 6d52698 =Update themes Mar 22, 2018
hugo-icarus @ 43d741e Update themes Jun 4, 2017
hugo-icon @ 92a6ad2 Update themes Jul 4, 2018
hugo-identity-theme @ ca4e10d Update themes Dec 21, 2017
hugo-incorporated @ 633cae6 Update themes Sep 27, 2016
hugo-initio @ 7400153 Add initio theme as submodule Mar 31, 2018
hugo-journal @ f125dc7 Update themes Jul 31, 2017
hugo-kiera @ ef5163d Update themes Dec 3, 2017
hugo-lamp @ 03cffab Update themes Jul 16, 2018
hugo-lithium-theme @ 3540603 Update themes Jul 4, 2018
hugo-lodi-theme @ e09d90a Update themes May 29, 2018
hugo-luxury-theme @ c9eff19 Add luxury theme Dec 21, 2017
hugo-material-blog @ b59661e Update themes Jul 8, 2018
hugo-mdl @ a2c6ae1 Update themes Aug 2, 2018
hugo-minimalist @ e2be2b4 Update themes Sep 10, 2017
hugo-multi-bootswatch @ ffd972e Update themes Nov 19, 2016
hugo-natrium-theme @ e006b52 Update themes Jul 4, 2018
hugo-nederburg-theme @ a5dfa15 Update themes Aug 2, 2018
hugo-now @ f837045 Update themes Mar 7, 2018
hugo-now-ui @ 3a9f459 Update themes Aug 8, 2018
hugo-nuo @ 782235b Update themes Aug 15, 2018
hugo-octopress @ 3462bf5 Update themes Jul 8, 2018
hugo-orbit-theme @ f89b1ee Update themes Jun 4, 2017
hugo-pacman-theme @ ec6a990 Update themes Jul 23, 2018
hugo-paper @ 69da3cc Update themes Jul 8, 2018
hugo-paper-now @ 8c8134c Add paper-now theme Dec 18, 2016
hugo-phlat-theme @ 04bd4fc Update themes Mar 30, 2018
hugo-plus @ 2c7d43d Update themes Jan 18, 2017
hugo-remark-minion @ 3377e99 Add remark-minio theme Dec 26, 2016
hugo-remark-twemoji @ fa6d586 Add remark-twemoji theme Dec 31, 2016
hugo-resume @ eca8431 Update themes Aug 11, 2018
hugo-shopping-product-catalogue-simple @ 0e96aa8 Update themes Aug 8, 2018
hugo-simpledoc-theme @ 53214e3 Update themes Feb 8, 2018
hugo-smorg @ 82ece58 Update themes May 1, 2018
hugo-smpl-theme @ 59f6d89 Update themes Dec 30, 2017
hugo-sodium-theme @ 6921f12 Update themes Aug 2, 2018
hugo-sp-minimal @ 2f3feb8 Add sp-minimal theme Nov 16, 2016
hugo-split-theme @ 12ff2ef Update themes Jun 2, 2018
hugo-startpage-theme @ 76b1a1f Update themes Jul 8, 2018
hugo-stellar-theme @ ac20424 Update themes Jul 4, 2018
hugo-sustain @ 3432f81 Update themes Aug 8, 2018
hugo-theme-arch @ 1526e3e Update themes Sep 1, 2017
hugo-theme-bootstrap4-blog @ 2981031 Update themes Aug 2, 2018
hugo-theme-cactus-plus @ 8754fb7 Update themes Feb 23, 2018
hugo-theme-cleanwhite @ 78c2d34 Update themes Aug 8, 2018
hugo-theme-den @ ed8918f Update themes Aug 2, 2018
hugo-theme-dopetrope @ 3d037bf Update themes May 18, 2018
hugo-theme-dream @ 6e04f49 Update themes May 12, 2018
hugo-theme-even @ d7fb92f Update themes Jul 8, 2018
hugo-theme-foundation6 @ aef046b Update themes Aug 2, 2018
hugo-theme-geppaku @ c3efde4 Update themes Feb 16, 2017
hugo-theme-hello-friend @ c287d99 Update themes Aug 2, 2018
hugo-theme-introduction @ db3bdd9 Update themes Aug 2, 2018
hugo-theme-jane @ 1af0209 Update themes Aug 15, 2018
hugo-theme-lean-launch-page @ a14fec4 Update themes Mar 13, 2018
hugo-theme-learn @ a56413d Update themes Aug 11, 2018
hugo-theme-massively @ b8d1ba6 Update themes Aug 15, 2018
hugo-theme-minos @ ae499bc Update themes May 29, 2018
hugo-theme-nix @ 67bbc50 Update themes Aug 15, 2018
hugo-theme-one @ b6f74bf Update themes Aug 15, 2018
hugo-theme-revealjs @ 3edd529 Add revealjs theme Jan 10, 2018
hugo-theme-sam @ 93dbce5 Update themes Aug 8, 2018
hugo-theme-vec @ 4e1c132 Update themes Jul 4, 2018
hugo-theme-w3css-basic @ 49286cc Update themes Aug 8, 2018
hugo-theme-wave @ 5f5fd71 =Update themes Mar 22, 2018
hugo-theme-winning @ 4b442f9 Update winning theme Aug 9, 2018
hugo-theme-zen @ b1f724e Update themes Jul 16, 2018
hugo-tracks-theme @ 8cefc99 Update themes Mar 30, 2018
hugo-tranquilpeak-theme @ 907866f Update themes Apr 24, 2018
hugo-travelify-theme @ c3bcd1c Update themes Jul 16, 2018
hugo-universal-theme @ ecd4366 Update themes Aug 15, 2018
hugo-uno @ a15471c Update themes Apr 4, 2017
hugo-xmag @ 506aaa7 Update themes Jul 23, 2018
hugo-xmin @ 6b05e21 Update themes Feb 23, 2018
hugo-zen @ cabdacf Update themes Feb 28, 2017
hugo_eiio @ 1387afa Update themes Apr 18, 2018
hugo_theme_pickles @ 0345c95 Update themes Aug 2, 2018
hugo_theme_solit @ 8a40188 Update themes Jul 4, 2018
hugoscroll @ 81f62e6 Update themes Apr 4, 2017
hugotube @ 0e62ae1 Update themes Aug 15, 2018
hugrid @ 6fd4b20 Update themes Aug 2, 2018
hurock @ 6e111b8 Update themes Apr 4, 2017
hyde @ 72d4bdf Update themes Aug 8, 2018
hyde-hyde @ 600b75f Update themes Aug 15, 2018
hyde-x @ 19bb3b2 Update themes Feb 8, 2018
hyde-y @ bd93bda Update themes Aug 9, 2018
internet-weblog @ 0c39cde Update themes Feb 8, 2018
journal @ e543e4b Update themes to latest and shiniest Nov 7, 2015
kiss @ ba36599 Update themes Aug 2, 2018
kraiklyn @ d3dc56d Update themes Aug 11, 2018
kube @ b17bb8d Update themes Mar 30, 2018
landing-page-hugo @ ef753c1 Update themes Apr 18, 2018
lanyon @ e117979 Update themes May 29, 2018
light-hugo @ 82bbfc0 Update themes Jun 11, 2017
liquorice @ 25c262d Update themes Oct 10, 2017
mainroad @ eb64c2c Update themes Aug 15, 2018
manis-hugo-theme @ 7770441 Update themes May 6, 2018
martial-paper @ 5cb03b9 Update themes May 12, 2018
material-design @ 587b3af Update themes Sep 2, 2016
material-docs @ 52e721a Update themes Apr 14, 2017
material-lite @ 24a23e3 Update themes Dec 2, 2015
min_night @ 764f792 Update themes May 29, 2018
minimage @ ac942cb Add minimage theme Aug 4, 2018
minimal @ 488ca07 Update themes May 29, 2018
minimal-academic @ 9a8e856 Add minimal academic theme Aug 4, 2018
minimo @ 9db19f9 Update themes Aug 15, 2018
navigator-hugo @ b359ffd Update themes Jul 16, 2018
newsprint @ b8c10f4 Update themes Sep 1, 2017
next @ f479d20 Update themes Apr 8, 2017
nixon @ 142e0a6 Update 10 themes: academic, blank, bleak, etc. Dec 20, 2016
nofancy @ ae46702 Update themes Mar 30, 2018
onetwothree @ ad62d40 =Update themes Mar 22, 2018
osprey @ 8212ba4 Update themes Jul 4, 2018
paperback @ 5251fea =Update themes Mar 22, 2018
persona @ eb0c597 Update themes Mar 30, 2018
phugo @ c6775f1 Update themes Apr 8, 2017
pixyll @ 0e0e558 Update themes Aug 8, 2018
plain-blog @ 7c53f49 Update themes Mar 22, 2017
polymer @ d8be002 Add polymer Jun 30, 2015
potato-dark @ f118ad1 Update themes Jul 4, 2018
pristine @ 8d2a1d1 Update themes Aug 2, 2018
projecthub @ d0fb856 Add projecthub Jul 29, 2015
prologue @ e537b6f Update themes Feb 1, 2017
purehugo @ 8e8cd01 Update themes Jan 26, 2018
redlounge @ f4a97c7 Update themes Jul 22, 2017
retrofulhugo @ a7d643f Update themes Nov 12, 2017
reveal-hugo @ 3cf1542 Update themes Aug 15, 2018
robust @ d45f4ef Update themes Jul 4, 2018
rocktopus @ c47bcd7 Update themes Feb 17, 2016
seminyak @ 56e2b0f Update themes May 18, 2018
shiori @ e23d4a1 Update themes Feb 17, 2016
simple-a @ fb73012 Update themes Feb 16, 2017
simple-hugo @ b5adcb7 Update themes Nov 19, 2016
simpleit-hugo-theme @ 06f9b96 Update themes Aug 15, 2018
simplicity @ 4be7a99 Update themes May 12, 2018
slate @ 8a62aa2 Update themes Jul 16, 2017
slim @ 77e7b0e Update themes Jul 16, 2017
sofya @ 8169d81 Update themes Feb 10, 2017
startbootstrap-clean-blog @ 5e66eed Update themes Mar 30, 2018
steam @ 31b22bb Update themes Jun 11, 2017
strange-case @ 9250dea Update themes Oct 26, 2017
strata @ 1dad042 Update themes Nov 5, 2017
sublime-hugo-theme @ 47b2988 Add sublime theme Apr 26, 2018
tachyons @ a98c649 Update themes Jul 19, 2015
tale-hugo @ c254011 Update themes Aug 8, 2018
temple @ 35cc7b9 Update themes Mar 7, 2018
theer @ 9ba0758 Add theer theme Jul 8, 2018
tinyce @ 0203a34 Update themes May 1, 2018
twentyfourteen @ 83f0a78 Update themes May 17, 2016
type @ 51aef3a Update themes Sep 10, 2017
vex-hugo @ 425e5ed Add vex-hugo theme Jun 1, 2018
vienna @ f050f58 Update themes Dec 3, 2017
whiteplain @ 7023595 Update themes Jul 16, 2018
would-have-been-cool-in-the-80s @ 6757af2 Update themes May 12, 2018
yourfolio @ bec3398 Update themes Jun 13, 2018
.gitignore Add hugoThemeSite dir to .gitignore Apr 19, 2017
.gitmodules Add missing ".git" suffix to URLs in .gitmodules Aug 11, 2018
LICENSE Initial commit May 23, 2014
README.md Clarify theme submission guidelines in README.md Jul 28, 2018
buildThemeSite.sh Revert "Reintroduce: Update submodules on build" May 27, 2017
netlify.toml Bump Hugo version to 0.46 Aug 10, 2018
requirements.txt build: Add Pygments Apr 17, 2017

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/gohugoio/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/gohugoio/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. Please DO NOT open a pull request!

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;
  4. A good README;
  5. To have https://example.com as base url in exampleSite/config.{toml, yaml, json} to avoid the abuse of unused domains.

theme.toml

This file contains metadata about the theme and its creator. Only theme.toml is accepted, not theme.yaml or not theme.json. The following fields are required:

name = "Theme Name"
license = "MIT"
licenselink = "Link to theme's license"
description = "Theme description"
homepage = "Website of your theme"
tags = ["blog", "company"]
features = ["some", "awesome", "features"]
min_version = 0.38

[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"

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.