README.md

Awesome Hugo

A curated list of awesome things related to Hugo, the world's fastest framework for building websites.

Hugo is a general-purpose website framework—written in Go—that generates static webpages.

Websites built with Hugo are extremely fast and secure. Hugo sites can be hosted anywhere… and work well with CDNs. Hugo sites run without the need for a database or dependencies on expensive runtimes like Ruby, Python, or PHP. We think of Hugo as the ideal website creation tool with nearly instant build times, able to rebuild whenever a change is made.

— Paraphrased from "What is Hugo".

Contents

• Awesome Hugo
  • Contents
  • Resources
    • Official
    • Non-Official
  • Tools
  • Starters
  • Theme Components
  • Projects using Hugo
  • Books
  • Articles
  • Gists
  • Contributing

Resources

Official

• GitHub
• Twitter
• Website
  • News
  • Docs
  • Themes
• Discussion Forum
• Gitter Channel (for Hugo development discussion only)

Non-Official

• Hugo Best Practices

Tools

• Hugo CLI
• Hugo Helper for Visual Studio Code
• Hugo Language and Syntax Support for Visual Studio Code
• Hugo Integration for all IntelliJ-based IDEs
• medium-2-md, Converts medium posts (html) into Jekyll/Hugo compatible markdown files
• Hugo Themer, Extension to help you building Hugo templates
• Prettier Plugin go-template, Fixes formatting for go template files.
• HUGE - A Hugo Framework

Starters

• Docker Image for Hugo
• Victor Hugo (starter repo for using Webpack)
• Hugo Webpack Boilerplate
• Hugo + Gulp starter project
• Hugo Starter with Gulp Asset Pipeline, SVG Icons, partials for global components, metadata, and social.
• Atlas: Hugo boilerplate
• Hugo's Pipes functionality using TailwindCSS and PurgeCSS
• GitHub Actions for Hugo extended
• GitHub Action to build Hugo site
• hugo-bin: Binary wrapper for Hugo
• Hugo Landing Page (demo)
• Hugo + Tailwind boilerplate
• Hugo + Tailwind 3 - SEO Optimized Starter
• HUGE starter: PostCSS, Tailwind and React
• HUGE basic starter: NPM free, SCSS and vanilla JS
• Hugo Theme Starter

Theme Components

• hugo-chart - A Hugo theme component to display beautiful Charts.
• hugo-cloak-email - A Hugo theme component to cloak email addresses.
• hugo-notice - A Hugo theme component to display nice notices.
• hugo-loremipsum - A Hugo theme component to generate Lorem ipsum.
• hugo-social-metadata - A Hugo theme component to generate social metadata.
• hudo-redirect - A Hugo theme component to setup URL redirections/aliasing on Hugo sites.
• hugo-cite - A Hugo theme component which uses CSL-JSON to create (academic) bibliography sections for pages and posts.
• hugo-responsive-images - A Hugo theme component for generating responsive images with srcset tags. Supports lazysizes for automatic sizes property and lazyloading polyfill.
• hugo-inline-svg - A theme component for inlining SVG. Comes with CSS for displaying as blog, or inline with text.
• hugo-github-calendar - A Hugo theme component for creating a graph of your GitHub contributions.

Projects using Hugo

• Madewithover.com
• Vote.gov (repo)
• Visit Paris Region
• Tomango (repo)
• Visual Cinnamon
• Virginia.gov
• Tapfiliate
• Smallmultiples
• Datadoghq (repo)
• Hartwell Insurance
• Let's Encrypt (repo)
• Brightline Initiative
• Netlify
• Pretty Fly FPV
• Forestry.io (repo)
• Crossref
• Boris FX
• 1Password
• Smashing Magazine
• Cinematt (repo)
• Boomtown Fair
• labs.usa.gov
• The Webmaster
• eSolia (repo)
• Rick Cogley Central (repo)
• Japan VAD Council
• Japan PVAD Council
• mbedded.ninja
• Nozbe
• Kubernetes (repo)
• Gitea
• Budibase
• SpotlightPA (repo)
• statsandr.com (repo)
• Bootstrap (repo)
• Random Daily Art
• Sociocs
• Shoogle

Books

• Hugo in Action - Static sites and dynamic Jamstack apps - By Atishay Jain, ISBN: 9781617297007.
• Build Websites with Hugo. Fast Web Development with Markdown - By Brian P. Hogan, ISBN: 9781680507263.

Articles

• Hugo: Beyond the Defaults - By Nate Finch.
• 6 Static Blog Generators That Aren't Jekyll - By David Turnbull, Sitepoint.
• Static Site Generators are Overkill - By Valeri Karpov.
• Comparing Static Site Engines - By Brian Rinaldi at SFHTML5.
• Major Release for Hugo - By Steve Francia.
• Making Content Editors and Web Developers Happy Again - By Code.Makery.
• Deploying Static Sites to CloudFront - By James Turk.
• How To Use NPM As A Build Tool With Hugo - The Codestead - By Isaac Gregson.
• Bleve Search for Hugo Sites - By Bleve.
• Hugo on Netlify — Insanely Fast Deploys - By Netlify.
• Why did eSolia Choose Hugo? A static site generator optimized for performance - By Rick Cogley, eSolia.
• Hugo Tutorial: Build and Host a Fast E-commerce site
• Static sites go all Hollywood - By Phil Hawksworth.
• Hands on Experience with Hugo as a Static Site Generator - By Thomas Peham, Usersnap.
• How To Install and Use Hugo, a Static Site Generator, on Ubuntu 14.04 - By Justin Ellingwood.
• Static Website Generators Reviewed: Jekyll, Middleman, Roots, Hugo - By Mathias Biilmann, Smashing Magazine.
• The World's Greatest (Free) Static Site Builders/Generators - By Vienna.html.
• How to host Hugo static website generator on AWS Lambda - By Ilya Bezdelev.
• Implementing blog theme bells and whistles in Hugo: pagination, pages, related posts, and tag lists - By Justin Dunham.
• Developing a Static Site Generator Workflow - By Thomas Peham, Sitepoint.
• Working with Hugo's Internal Partial Templates: twitter-cards - By Brendan Quinn.
• Tips and tricks for building a theme in Hugo - By Jeff McMorris.
• Switching to Aerobatic Static Site Hosting - By Ryan Brown, Serverless Code.
• Leverage shortcodes in Hugo - By Julio Pescador.
• How to use Data Files in Hugo: an example - By Peter Y. Chuang.
• Considerations when converting from WordPress.com to Hugo - By Elmar Klausmeier.
• Limitations of Hugo's Date Format Templating - By Paul Heinlein.
• Better TeX math typesetting in Hugo - By Lincoln.
• Moving to a static site - By David Yates.
• AWS Lambda Static Site Generator Plugins - Alestic.com - By Eric Hammond.
• Hosting Hugo on GitLab - By Bryan Klein.
• HugoPhotoSwipe - By Gertjan van den Burg.
• Serve static websites with Caddy web server - By Peter Y. Chuang.
• How to show related posts in Hugo - By Peter Y. Chuang.
• Hugo dateFormat - By GoHugoHQ.
• Them's Good Broth! | Adding Isso Comments To Hugo - By Stíobhart Matulevicz.
• An Example of a Static Site with a Dynamic Calendar · Raymond Camden - By Raymond Camden.
• How to create a first-letter indexed list - By GoHugoHQ.
• Activity Calendar Partial - By GoHugoHQ.
• How to schedule posts for static site generators (Jekyll, Hugo, Phenomic etc.) - By David Wells.
• Compare date strings in hugo - By GoHugoHQ.
• Installing bleeding edge Hugo + Goorgeous - By Kaushal Modi.
• Go offline! Service Worker and Hugo - By gohugohq.
• Autolinking shortcode through articles - By GoHugoHQ.
• Twitter cards partials for Hugo - By GoHugoHQ.
• Enabling offline usage of a Hugo site (PWA) - By Michel Racic.
• Go static: 5 reasons to try JAMstack on your next project. - By Tom Bennet, Builtvisible.
• Dealing with version conflicts between Hugo and Netlify - By Adam Wills.
• Hugo.Scratch explained - By Régis Philibert.
• Hugo Easy Gallery - By Li-Wen Yip.
• Getting Hugo running on Netlify - By Richard Littauer.
• Hugulp, a Hugo + Gulp toolchain - By Juan B. Rodriguez.
• Replacing Disqus with GitHubComments - By Don Williamson.
• Converting WordPress Export File to Hugo - By Elmar Klausmeier.
• Migrate from Octopress to Hugo - By Sergey Pisarenko.
• Creating a JSON Feed for Hugo - By Raymond Camden.
• Delaying Disqus comments to save (a ton of) requests - By Igor Kulman.
• HBuild, Test, And Deploy Statically Generated Websites With Hugo - By Ricardo Feliciano, CircleCI.
• Migrating from Jekyll+GitHubPages to Hugo+Netlify - By Sara Soueidan.
• Deploying Hugo on Bluemix - By Ryan Tiffany, dev.to.
• Building a JAMstack site with Hugo and Azure Functions - By Henrik Lau Eriksson.
• Embed your typeform on Hugo sites - By Typeform.
• Automating Static Website Deployment, Part 1 - By AlphaGeek.
• A Gentle Introduction to Creating a Minimal Hugo Site - By Arun Ravindran.
• Generating Comments on Static Sites with Staticman - By tosbourn.
• Implementing a Series in Hugo - By Joe Sacher.
• Hugo Hosting with KeyCDN - By KeyCDN.
• Hugo Templates for WordPress Designers - By Leon Barnard, Treehouse Blog.
• Hugo and Madoko in a Custom Docker Image for GitLab CI/CD - By Brian Klein.
• Notes about migrating to Hugo - By Fatih Arslan.
• Hugo Translator - By Régis Philibert.
• Hugo + Staticman: Nested Replies and E-mail Notifications - By Dan C Williams.
• Hugo Web Development Workflow on Windows - By Ashwin Narayan.
• How to build custom Hugo pagination - By Glenn McComb.
• Hugo Page Resources - By Régis Philibert.
• Hugo vs Jekyll: Benchmarked - By Chris Macrae, Forestry.io.
• Content Groups in Hugo for Google Analytics - By Bruno Amaral.
• Hugo: Leaf and Branch Bundles - By Kaushal Modi.
• Client side searching for Hugo.io with Fuse.js - By Eddie Webb.
• Using Python, Webtask.io, Stripe, and Hugo for charity Fundraising pages - By Bryan Klein.
• Better Relationships in Hugo - By Régis Philibert.
• Hugo Snippets and Code Examples - By Julian Knight.
• Subscription form for Hugo with FlowXO and Mailgun - By Krister Viirsaar.
• Build a JSON API With Hugo's Custom Output Formats - By Régis Philibert, Forestry.
• Hugo, Python and Sheets, Oh My! - By Bryan Klein.
• How to move from Medium to static hosting with Jekyll or Hugo - By Matt Sherman.
• Enhance Your Hugo JSON API Using Custom Output Formats and Netlify Redirects - By Régis Philibert, Forestry.io.
• Create a blog using pre-built Serverless Components and Hugo - By Rupak Ganguly.
• How to cache-bust and concatenate JS and SASS files with Hugo in 2018 - By Ben Bozzay.
• How to use Hugo template variables in SCSS files (in 2018) - By Ben Bozzay.
• Hugo Pipes' Revolution - By Régis Philibert.
• Hugo tips: How to create author pages - By Irene Morente, Netlify.
• Gatsby vs Hugo, a detailed comparison - By Developer Davo.
• Why I keep Hugo in my Repository and How I Update it with Python - By Bryan Klien.
• How I migrated this website articles from Jekyll to Hugo - By Marcelo Canina.
• Hugo Multilingual Part 2: Strings localization - By Régis Philibert.
• WordPress to Static Site Generator (Hugo) Migration and Deployment - By Phong Huynh.
• Configure Hugo to Ingest into Elasticsearch
• Schema Markup For Hugo - By Desmond Lua.
• Setup Hugo with GitLab CI on Ubuntu remote server - By M M Arif.
• Style a markdown table with Bootstrap classes in Hugo - By Zachary Betz.
• Processing Responsive Images with Hugo - By Laura Kalbag.
• How to add Isso comments to your site - By M M Arif.
• Make a Hugo blog from scratch - By Zachary Betz.
• Making Hugo's Footnotes Accessible - By Daniel Post.
• Deploy your Hugo site through SSH with Travis - By Nicolas Martignoni.
• Static site search with Hugo + Algolia - By Chris Macrae.
• How to Add Copy to Clipboard Buttons to Code Blocks in Hugo - By Danny Guo.
• Preview your site from any device on your network with these hugo server options - By Zachary Betz.
• TGIH: Themeless & Gitless Introduction to Hugo - By Nancy McGough, Infinite Ink.
• Modular content modeling with Forestry's Front Matter Templates and Hugo - By Nicholas Gracilla.
• Building This Website - By Josh Bradley.
• Add Search to a Hugo site with Lunr.js and Node.js - By Hugo Di Francesco.
• Automate scheduled builds with Hugo, Netlify, and GitLab's CI/CD pipeline - By Nicholas Gracilla.
• Create Your Free Developer Blog Using Hugo And Firebase - By Zara Cooper.
• Hugo modules for "dummies" - By Jon Arne Viksås.
• Add search functionality to your blog listing page - By Zachary Betz.
• Hugo Mini Course (en/ru) - By Jason Rametta & Valeria Shpiner.
• "Static" Comments with Gulp, Hugo & Netlify - By ttntm.
• Building a Store Locator Based on Leaflet - By ttntm.
• Hugo Modules: everything you need to know! - By Régis Philibert.
• Developing a Last.fm shortcode for Hugo - By Eric Goebelbecker.
• Build a Search Bar for Your Hugo Blog With a JSON Index and Some Vanilla JS - By Zachary Betz.
• Redirects Hugo Module with Netlify - By Régis Philibert.
• Discreet Drafts in Hugo - By Zachary Betz.
• How to Use PurgeCSS With Hugo - By Zachary Betz.
• Comments via Matrix: Cactus Chat and Hugo - By Julian-Samuel Gebühr.
• A lightweight, fuzzy, client-side search template for Hugo - By Zachary Betz.

Gists

Gists are succinct code snippets. Please only include things that are useful to many.

• #gohugo search index with "some" stop words removed
• Hugo zsh functions for local serving and deploying via rsync
• Hugo recursive navigation partial

Contributing

Found an awesome package, article, blog, video etc.? Send me a pull request! Just follow the guidelines. Thank you!

---

Maintained by Bud Parr at The New Dynamic.