Awesome hugo blog | Demo

⚡ Fast | 📰 Clean UI | 🌙 Dark mode support | 📱 Responsive design

Features

• Minimal design
• Responsive design
• Light and dark mode
• Syntax highlighting
• RSS feed
• No jQuery, Bootstrap
• 100/100 Google PageSpeed Insights score on all 4 metrics

Screenshots

Dark mode	Light mode

Page speed score:

Google PageSpeed Insights test link.

Setup

Note: you need to have the Hugo extended version installed in order to use this theme. This theme uses SCSS for styling. With Hugo extended version, SCSS can be compiled to CSS without any additional tool.

To create a new Hugo site with this theme, run the following command:

hugo new site myblog

Then, clone this repository into the themes directory of your new site:

cd myblog
git clone https://github.com/hugo-sid/hugo-blog-awesome.git themes/hugo-blog-awesome

To preview the thmeme with example content, run the following command from the exampleSite directory:

hugo server --themesDir ../..

Usage

To use this theme, set the theme variable in your site’s config.toml to hugo-blog-awesome:

theme = "hugo-blog-awesome"

Configuration

You can have a look at the config.toml file in the exampleSite directory for an example configuration. It is recommend that you to copy the config.toml file from the exampleSite directory to the root directory of your Hugo site. You can then edit the config.toml file to suit your needs.

Adding favicon

I used realfavicongenerator.net to generate the favicons. You can place the resulting files in the static\images\favicon folder. That should get your favicon working.

If you want to customize anything further, you can modify layouts\partials\head.html.

Adding Social icons

Social icons can be added by congifuring config.toml file in the following manner.

[[params.socialIcons]]
name = "github"
url = "https://github.com/hugo-sid"

[[params.socialIcons]]
name = "twitter"
url = "https://twitter.com"

[[params.socialIcons]]
name = "Rss"
url = "index.xml"

If you are trying to add an icon which is not listed above, you can modify layouts\partials\svgs\svgs.html to include your icon (SVG). You are encouraged to submit your icon by creating a pull request, so that other can benefit.

Content

Posts

To create a new post, run the following command:

hugo new posts/my-first-post.md

Then, edit the my-first-post.md file to suit your needs.

Contributing

If you find any bugs or have any suggestions, feel free to open an issue or a pull request.

Websites using this theme

If you are using this theme for any website, feel free to list the website here. You can submit a pull request (PR) to include your website.

Support

Don’t forget to ⭐️ the repo if you liked this theme!

Credits

The social icons are made possible thanks to Aditya Telange’s hugo-PaperMod theme.

License

This theme is released under the MIT license. For more information read the License.

See Also

• Academic
• Color Your World
• Gokarna
• Paige
• PaperMod