Hugo port of the Jekyll theme contrast, retaining the minimal typography style
contrast-hugo — Hugo Starter Template
By niklasbuschmann
contrast-hugo is a Hugo port of the Jekyll theme contrast, presenting content with minimal typography and configuring the theme, menus, and excerpt display through configuration files.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Actual screenshot captured by the server browser.
All pages & views 3
Screenshots show visual appearance; interactive behavior may differ.
What stands out
A quick read of the recorded project description.
Enabled by cloning into the themes/ directory and setting the theme field in hugo.yaml
Menus are divided into main and social groups, supporting ordering by weight
Social menu items can specify icons via identifier; examples include envelope, github, and rss
params.excerpts toggles whether summaries are displayed in lists
The repository uses the Unlicense, so the code may be freely copied, modified, and distributed
Template Details
contrast-hugo is niklasbuschmann's adaptation of the Jekyll theme contrast to Hugo, described in the repository as a "Minimalistic Hugo theme." It does not provide a page builder or component library; instead, it works through Hugo's theme mechanism: clone the repository into the project's themes/ directory, then declare theme: "contrast-hugo" in hugo.yaml to enable it.
At the configuration level, the examples in the README focus on two parts: params.excerpts and menu. excerpts controls whether summaries are displayed. The menu is divided into main and social groups, each item containing name, url, and weight. Social items can also include an identifier to correspond to an icon (the examples use envelope, github, and rss). The theme's demo site and screenshots cover the homepage, inner pages, and mobile views, which can be used to understand the actual typography.
The materials do not specify which content types, shortcodes, or build processes the theme includes, nor do they give a Hugo version requirement; before use, you need to confirm compatibility with your current Hugo version. The repository uses the Unlicense, so the code may be freely copied, modified, and distributed, but third-party assets such as demo images, fonts, and icons require separate license verification.
Is it right for your project?
Use Cases
- Building a lightweight Hugo theme for a personal blog or text-based site
- Migrating an existing Jekyll contrast site to Hugo
- Static sites that need top navigation and social links defined through configuration files
- As a reference project for learning Hugo theme structure and menu configuration
Suitable For
- Developers building static sites with Hugo
- Bloggers who prefer minimal typography and text-focused content
- Users who need a permissive license and the ability to modify the theme code themselves
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
In the project root, run cd themes/ and then git clone https://github.com/niklasbuschmann/contrast-hugo.git
- 2
Add theme: "contrast-hugo" at the top of hugo.yaml
- 3
Set excerpts under params as needed, and configure main and social menu items under menu
- 4
The materials do not give a Hugo version requirement; before use, confirm compatibility with your local Hugo version
- 5
Third-party assets such as demo images, fonts, and icons require separate license verification and are not covered by the code's Unlicense
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version in the public repository under the Unlicense; the free scope is the code of that version and does not mean external services or third-party assets are free.
Must comply with when using
- The code of this version may be freely copied, modified, published, used, compiled, sold, and distributed, including for commercial purposes.
- The author waives related copyright through a public-domain dedication; the legal effect of that dedication depends on the applicable jurisdiction.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses and cannot be judged solely by the code's Unlicense.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis
https://github.com/niklasbuschmann/contrast-hugo/blob/master/LICENSE.txthttps://github.com/niklasbuschmann/contrast-hugo/blob/master/README.mdfor any purpose, commercial or non-commercial, and by any means
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-03. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- Hugo Themes
- Documentation and maintenance reference score
- Partly documented · 73 / 100
- Technologies
- Hugo
- Website type
- Starter
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2025-08-16
- Screenshot last checked
- 2026-10-03
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Hugo as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: 1b8a731b658b4c44c51a03113aef5aa796575336f3becce9ba30ae6259c570e9
2026-10-03T18:48:59.448Z
Source file / repositoryAdaption of the of [contrast](https://github.com/niklasbuschmann/contrast) Jekyll theme.
## Installation
To install Contrast as your default theme, first install this repository in the `themes/` directory:
$ cd themes/
$ git clone https://github.com/niklasbuschmann/contrast-hugo.git
Second, specify `contrast-hugo` as your default theme in the `hugo.yaml` file. Just add the line
theme: "contrast-hugo"
at the top of the file.
An example `hugo.yaml` could look like this:
```yaml
theme: "contrast-hugo"
params:
excerpts: false
menu:
main:
- {name: "Home", url: "/", weight: 1}
- {name: "About", url: "/about/", weight: 2}
social:
- {name: "Mail", url: "mailto:", identifier: "envelope", weight: 3}
- {name: "Github", url: "https://github.com/", identifier: "github", weight: 4}
- {name: "Subscribe", url: "/index.xml", identifier: "rss", weight: 5}
```
Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-xmin
hugo-xmin is an extremely minimal Hugo theme written by Yihui Xie for template beginners. HTML and CSS total about 140 lines, with no external dependencies, and it uses the MIT license.
Hugo · Starter

hugo-theme-gallery
A Hugo Extended photo gallery theme that organizes images with Page Bundles, automatically generating album lists and gallery pages with a Justified layout and PhotoSwipe lightbox.
Hugo · Starter

reveal-hugo
reveal-hugo is a Hugo theme that converts Markdown content into Reveal.js-based HTML presentations. It supports slide separation with `---`, shortcodes for fragments, slides, sections, notes, Markdown, and MathJax, and organizes content as root or section presentations with order controlled by weight.
Hugo · Starter

anatole
Anatole is a minimalistic two-column Hugo theme ported from farbox-theme-Anatole, featuring dark mode, multilingual and RTL support, and optional portfolio, comments, analytics, KaTeX, and Mermaid integrations. It suits personal blogs, portfolios, or documentation sites built with Hugo.
Hugo · Starter

hugo-theme-diary
A Hugo diary-style theme ported from the Hexo theme Journal, with a grid homepage for essays and daily notes. It supports six languages, dark mode, table-of-contents scroll positioning, reading time, code highlighting, and configurable sidebar, fonts, and colors.
Hugo · Starter

risotto
risotto is a minimalist, responsive Hugo theme inspired by terminal ricing aesthetics. It uses semantic HTML and pure CSS with no JavaScript, and its layout relies on CSS Grid for native responsiveness without manual breakpoints.
Hugo · Starter
