Include Hugo internal templates (Open Graph, Disqus, Google Analytics)
New responsive menu without jQuery
BEM-like class naming
SVG icons instead of font icons
Theme options are saved (Sidebar position, Author Box, Post Navigation) and available through config.toml file parameters
Other small changes
Desktop: IE9+, Chrome, Firefox, Safari
Mobile: Android browser (on Android 4.4+), Safari (on iOS 7+), Google Chrome, Opera mini
Other browsers (like Opera on Blink engine) are also supported, but not tested. Support for older versions of Internet Explorer (IE8 and below) ended.
In your Hugo site themes directory, run:
$ git clone https://github.com/vimux/mainroad
Next, open config.toml in the base of the Hugo site and ensure the theme option is set to mainroad:
theme = "mainroad"
For more information read the official setup guide of Hugo.
baseurl = "/"
title = "Mainroad"
languageCode = "en-us"
paginate = "10" # Number of posts per page
theme = "mainroad"
disqusShortname = "" # Enable comments by entering your Disqus shortname
googleAnalytics = "" # Enable Google Analytics by entering your tracking id
name = "John Doe"
bio = "John Doe's true identity is unknown. Maybe he is a successful blogger or writer. Nobody knows it."
avatar = "img/avatar.png"
subtitle = "Just another site" # Subtitle of your site
description = " John Doe's Personal blog about everything" # Description of your site
opengraph = true
readmore = false # Show "Read more" button in list if true
leftsidebar = false # Move sidebar to the left side if true
authorbox = true
post_navigation = true
postSections = ["post"] # the section pages to show on home page and the "Recent articles" widget
#postSections = ["blog", "news"] # alternative that shows more than one section's pages
#dateformat = "2006-01-02" # change the format of dates
search = true # Enable "Search" widget
recent_articles = true # Enable "Recent articles" widget
recent_articles_num = 10 # Set the number of articles in the "Recent articles" widget
categories = true # Enable "Categories" widget
tags = true # Enable "Tags" widget
tags_counter = false # Enable counter for each tag in "Tags" widget (disabled by default)
# Enable "Social" widget, if any of "social_*" set a value
social_facebook = "username"
social_twitter = "username"
social_linkedin = "username"
social_github = "username"
social_email = "firstname.lastname@example.org"
Delete unused CSS
No ID in CSS
Responsive menu without jQuery
Delete unused JS
Social media widget
i18n support (Internationalization)
Detailed documentation (?)
Enhanced version of recent posts widget (?)
Tabbed widget (?)
Have you found a bug or got an idea for a new feature? Feel free to use the issue tracker to let me know. Or make directly a pull request.
This theme is released under the GPLv2 license (inherited from the original MH Magazine lite WordPress theme).