HugoStarter

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.

3 previews
Desktop homepage1 / 3
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 3

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-03View source

What stands out

A quick read of the recorded project description.

01

Hugo port of the Jekyll theme contrast, retaining the minimal typography style

02

Enabled by cloning into the themes/ directory and setting the theme field in hugo.yaml

03

Menus are divided into main and social groups, supporting ordering by weight

04

Social menu items can specify icons via identifier; examples include envelope, github, and rss

05

params.excerpts toggles whether summaries are displayed in lists

06

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.

HugoStarter

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. 1

    In the project root, run cd themes/ and then git clone https://github.com/niklasbuschmann/contrast-hugo.git

  2. 2

    Add theme: "contrast-hugo" at the top of hugo.yaml

  3. 3

    Set excerpts under params as needed, and configure main and social menu items under menu

  4. 4

    The materials do not give a Hugo version requirement; before use, confirm compatibility with your local Hugo version

  5. 5

    Third-party assets such as demo images, fonts, and icons require separate license verification and are not covered by the code's Unlicense

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This 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

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 / repository
Adaption 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}

```
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.

hugo-xmin

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

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

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

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

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

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