Roadster

Roadster is a clean, content-first Hugo theme for blogs and publishing sites, forked from the Mainroad theme and focused on readability and modern publishing features. It accepts standard Hugo Markdown content and front matter and produces a static HTML website with a responsive layout, widgetized sidebar, and built-in social sharing metadata.

What is Roadster?

Roadster is a Hugo theme, meaning it provides the templates, styles, and configuration for a static site generated by Hugo. As input, it takes Markdown posts, pages, and author data; as output, it generates a fast, static HTML site. The theme is maintained on GitHub by mansoorbarri and is a fork of Vimux's Mainroad theme, with issues and pull requests from the original project accounted for.

Key Features

• Responsive design — Layouts adapt to mobile, tablet, and desktop screen sizes, with no extra setup required.
• Configurable theme settings — Sidebar position, author box, post navigation, and highlight color can be adjusted from the Hugo site config.
• Widgetized sidebar — Add content widgets such as recent posts, categories, and tags through the theme's widget system.
• 15+ languages — Includes translation files for over fifteen languages, covering common locales.
• SEO and social integration — Uses Hugo's internal templates for Open Graph, Schema, Twitter Cards, Disqus comments, and Google Analytics.
• Content tools — Table of Contents, MathJax math rendering, and SVG icons are built in.
• Custom Google Fonts — Font family, weights, and other properties are configurable from the theme settings.
• Cross-browser compatibility — Styling is tested to work across major modern browsers.
• Multiple authors — Posts can be assigned to different authors, and author pages are supported.

Who is it for?

Roadster is aimed at bloggers who want a no-frills, content-first design with clean typography. It also suits technical writers and teams who publish multi-author blogs and need author attribution. Developers who prefer Hugo's simplicity and speed can use Roadster as a starting point for a personal or project site.

What can you do with Roadster?

Bloggers: publish Markdown posts and automatically get Open Graph and Twitter Cards for social sharing. Technical writers: create documentation sections with a Table of Contents and clean reading layout. Development teams: deploy a multi-author corporate blog with per-author pages and built-in Google Analytics integration.

How does Roadster work?

After installing Hugo, you clone or submodule the repository into the themes/roadster folder of your site. Set theme = "roadster" in hugo.toml, then run Hugo to build the static site. The theme reads your content files and uses its templates to assemble pages, widget areas, and metadata.

Pricing

Roadster is free and open source under the MIT license.

Alternatives

Mainroad is the upstream theme from which Roadster was forked, offering the same general layout with less modern configuration.

FAQ

Is Roadster free to use?

Yes. Roadster is released under the MIT license, which allows free use, modification, and redistribution, including for commercial projects.

How do I install Roadster?

Clone the repository (or add it as a git submodule) into your Hugo site's themes/roadster directory. Then set theme = "roadster" in your hugo.toml configuration file. A step-by-step guide is available in the theme documentation.

Does Roadster support multiple authors?

Yes. Roadster includes multiple-author support, so you can assign each post to an author and display author bylines on posts.

What features are included out of the box?

Roadster offers a responsive layout, widgetized sidebar, table of contents, MathJax, SVG icons, custom Google Fonts, Open Graph, Schema, Twitter Cards, Disqus, and Google Analytics support, along with translations for more than fifteen languages.