HugoTool Site

would-have-been-cool-in-the-80s — Hugo Tool Template

By pedrodude

A minimalist retro-style theme for Hugo that emphasizes few dependencies and no scripts, with site- and page-level configuration notes.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

1 previews
Author preview
Author-provided previewTop of page

Preview provided in the project README.

One original preview is available. Open the full image to inspect the design.

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

A minimalist retro theme for Hugo, MIT licensed

02

No script dependencies, aiming for few dependencies and easy maintenance

03

Site configuration items to replace are marked with a TK prefix in config.toml

04

Page-level fields such as streamtitle, timeless, and coolinthe80slastmod are provided through an archetype

05

CSS is based on HTML5 Boilerplate and normalize.css, with custom styles prefixed whbcit8

06

Uses Montserrat from Google Fonts by default

Template Details

This theme is published by pedrodude on GitHub under the MIT license, and the repository provides the author's screenshot as a preview. The README positions it as a "minimalist, sort of retro" Hugo theme, with goals including being easy to modify and maintain, having as few load-time dependencies as possible (no scripts), and self-deprecatingly noting that its appearance is not its strong point. The visual inspiration comes from right-angled quadrilaterals and rounded corners (no chamfers).

In use, the theme relies on Hugo to generate a static site, and installation follows Hugo's official theme installation instructions. Site-level configuration is centralized in config.toml: fields beginning with TK must be changed, including theme, baseurl, languageCode, title, and under params: aboutpage (the filename of the about page without extension), author, copyrightstatement, description, plus optional siteclass (homepage subtitle) and tagline (slogan below the title). To add an introduction on the homepage, create a Markdown document in the content directory with frontmatter timeless = "indexintro" and title = "indexintro"; the README warns that this content appears before the page index and should not be too long.

Page-level configuration is provided through an archetype with additional fields: streamtitle displays a contrasting subtitle on a single page; when timeless is set to true, it hides the date in the article summary and title, but the modification date shown by pedrolastmod is unaffected; coolinthe80slastmod accepts a date in YYYYMMDD form and manually displays the modification date below the footer, showing the creation date when unset.

For styling, the CSS is adapted from HTML5 Boilerplate and normalize.css, includes a few override styles and custom styles prefixed with whbcit8, and suggests geometric sans-serif, monospace, or bold serif fonts; the default configuration uses Montserrat hosted by Google Fonts. The README states that the author did not extend features such as pagination further, that the theme is roughly one step beyond an MVP, and mentions that a site that once used the theme is now offline.

HugoTool Site

Is it right for your project?

Use Cases

  • Applying a retro geometric look to a personal blog or small static site
  • Needing a script-free, low-dependency starter theme in a Hugo project
  • Scenarios requiring manual control over article date display and last-modified dates
  • Quickly replacing site title, author, copyright, and description with a small set of configuration items

Suitable For

  • Users familiar with basic Hugo configuration and Markdown writing
  • Site authors who prefer minimalism, right-angle geometry, and retro color schemes
  • Developers willing to manually fill in config.toml and page frontmatter according to the README
  • Teams needing theme code that can be freely modified and distributed under the MIT license

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Install the theme according to Hugo's official theme installation instructions and set theme = "would-have-been-cool-in-the-80s" in config.toml

  2. 2

    Modify fields in config.toml that begin with TK and remove the TK, including baseurl, languageCode, title, and under params: aboutpage, author, copyrightstatement, description, plus optional siteclass and tagline

  3. 3

    aboutpage must be the filename of the about page without extension, otherwise the header about link will not work

  4. 4

    To add a homepage introduction, create a Markdown document in the content directory with frontmatter timeless = "indexintro" and title = "indexintro"

  5. 5

    Page frontmatter can use fields such as streamtitle, timeless, and coolinthe80slastmod (YYYYMMDD); coolinthe80slastmod is entered manually and is not automatically formatted

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 MIT license; the free scope is the code of that version and does not imply that external services or third-party assets are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the full MIT license notice.
  • 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

  • The default configuration loads the Montserrat font via Google Fonts, which is an external service dependency; offline or when Google Fonts is unreachable, the font will not render as in the default style, and you must replace or self-host the font.
  • The deployment stack described in the README relies on third-party paid services such as a Gandi.net domain, Amazon Route 53 DNS, and Amazon S3 storage; launching a site with this theme may incur corresponding costs and account requirements.
  • The README mentions using S3.exe to upload to S3, which is an external tool dependency that may require additional acquisition and configuration.
  • Using this theme requires installing the Hugo static site generator; the theme cannot run independently of Hugo.
  • 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 MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur separate charges.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

The default configuration uses a rather nice geometric sans-serif font called [Montserrat](https://www.google.com/fonts/specimen/Montserrat) hosted by Google Fonts.

Original README

- Domain from [Gandi.net](http://gandi.net) - DNS routing provided by [Amazon Route 53](https://aws.amazon.com/route53/) - Storage provided by [Amazon S3](https://aws.amazon.com/s3/)

Original README

S3 uploading provided by [S3.exe](https://s3.codeplex.com/)

Original README

you need hugo to use this theme

Original README
https://github.com/pedrodude/would-have-been-cool-in-the-80s/blob/master/LICENSE.mdhttps://github.com/pedrodude/would-have-been-cool-in-the-80s/blob/master/README.md

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
GitHub
Documentation and maintenance reference score
Partly documented · 56 / 100
Technologies
Hugo
Website type
Tool Site
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
2018-05-10
Screenshot last checked
2026-10-03

No demo link is recorded. Use the repository instructions to evaluate the project locally; the screenshot alone cannot establish interactive behavior.

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.

Automatically checked against source and license rules; no manual editorial review.

Inspect the recorded source material

SHA-256: 35c1fcdfbcf721c1e739727738560f128c0df5cc880320c110a50348ca89c7d1

2026-10-03T04:56:35.630Z

Source file / repository
would have been cool in the 80s
===============================

A minimalist, sort of retro theme.  Objectives are:

* Simple to adapt/maintain
* Fast loading with minimal dependencies (no scripting)
* Not entirely ugly - probably the weak link, let's be honest

The theme was inspired by the following geometric shapes to whom all credit is owed:

* All right-angled quadrilaterals
* The fillet (but not the chamfer)

~~A live site using this theme: [socratic.space](http://socratic.space) (warning: it's terrible)~~ Aaaand that site is soooo down now!  Not because of technical issues, no sir!  I just didn't want that domain any more (it sounded stupid, but you knew that).  Wow, guess you'll just have to trust me, a random person on the internet, instead.  Yikes.

## Screenshot

![WHBCIT8 screenshot](https://raw.githubusercontent.com/pedrodude/would-have-been-cool-in-the-80s/master/images/screenshot.png "WHBCIT8 screenshot")

## Installation

Generic installation instructions are [here](https://gohugo.io/themes/installing/)

## Setup

### Site configuration

To "make it yours" (even though we all know this theme is *mine*), change the bits of the following config.toml file that start with TK (and get rid of the TK)

---
```toml
#Adjust all settings that start with TK to customise this theme to your site.  Also remove the TK
theme = "would-have-been-cool-in-the-80s"
baseurl = "TK http://mysite.com"
languageCode = "en-us"
title = "TK MY SITE'S TITLE"

[params]
  aboutpage = "TK name-of-the-about-post" #This makes the "about" link in the header function.  It must be the exact filename of your about page without the file extension.  E.g. if your about page is called "mysiteabout.md" then enter in "mysiteabout"
  author = "TK Your Name" #Goes in the meta info of your webpage to help identify you as the author of the content
  copyrightstatement = "TK A copyright statement of your choosing." #Will appear in the footer of each page.
  description = "TK A description that will appear in the html meta" #Goes in the meta info of your webpage to describe the content of your site
  siteclass = "TK MY SITE'S SUBTITLE" #Optional.  If you set it, it will display a subtitle in a contrasting color (adjustable within the CSS) on the site's index page.
  tagline = "TK My site's witty tagline" #Optional.  If you set it, it will display a tagline for the website underneath the titles.  By default it appears italicized.
```
---

### Indexintro.md

To add in some introductory spiel to the index page, create a markdown document in your content folder with the following in your toml frontmatter:
```toml
timeless = "indexintro"
title = "indexintro"
```
To keep things simple there's no repositioning of the page index; so perhaps keep this bit short so as not to push the index too far down the page.

### CSS

The CSS is adapted from [HTML5 Boilerplate](http://gohugo.io).  Just a few layout and color tweaks.  There are some override styles and a few custom ones prefixed with "whbcit8".  In terms of font choice: geometric sans-serifs, monospace, and perhaps even slab serifs all seem to work fine.

That's about it.  I could have done more I'm sure with pagination and all that crap but I was basically going for one step beyond a MVP, as well as teaching myself HTML5 and CSS3, and this Hugo thingy.

### Individual page configuration

Page configuration is largely unchanged from the default but there are some additional bits in the archetype (the template that defines default page settings) which enable additional features.  It's explained in the comments in the template for your page frontmatter below.

---
```toml
+++
streamtitle="" #Optional.  If you set it, it will display a subtitle in a contrasting color (adjustable within the CSS) on the individual page.
timeless = "false" #Optional.  If you set it, it will determine whether the post displays date features (displaying a date on the post summary on the index page, date in the page title).  Changing the value to true suppresses all of these features, with the exception of the last modified date shown by the pedrolastmod parameter
draft=true
coolinthe80slastmod="YYYYMMDD" #Optional.  If you set it, it will display a Last Modified Date under the footer.  This is not automated at all, nor formatted, but simply provides a basic ability to indicate that the creation date differs from the modified date.  If left unchanged, it will display the created date.
+++

LOREM IPSUM PAGE CONTENT GOES HERE
```
---

## Dependencies (and acknowledgements)

### HTML5 Boilerplate [and Normalize.css]

Ok so I didn't do all of this theme myself.  I do embarrassingly rely on [HTML5 Boilerplate](https://html5boilerplate.com/) and [normalize.css](https://necolas.github.io/normalize.css/).  For a beginner like me these are excellent aides.  Although I was utterly dismayed to find that a shim like normalize.css was necessary.  Seriously, wtf?  I know that as a neophyte I probably sound completely ignorant here, and also that there's a ton of history behind this.  But goddamn, isn't there like a W3C, or perhaps ISO to tell people how to make a consistent renderer.  Whatever, these things meant I had to think less, so thank you!

### Hugo

Is [Hugo](http://gohugo.io) itself a dependency?  I don't know what I'm supposed to put in this readme but duh, you need hugo to use this theme.  And again the best part of it was it didn't require me to think a lot.  I roll Windows like a total web n00b and I'm usually using all my brainpower to not bump into things, so the fact I could just freaking download an .exe and not even have to add it to my path made me smile.  Seriously, who has time for that shit?

### Google Fonts

The default configuration uses a rather nice geometric sans-serif font called [Montserrat](https://www.google.com/fonts/specimen/Montserrat) hosted by Google Fonts.

## Supporting Infrastructure

And since this is a sort of starter theme from a starter aimed at starters; here's the "stack" of products that I'm using.  The skills you need to use these are the ability to read the instructions and a bit of batch scripting [to use S3.exe]:
- Domain from [Gandi.net](http://gandi.net)
- DNS routing provided by [Amazon Route 53](https://aws.amazon.com/route53/)
- Storage provided by [Amazon S3](https://aws.amazon.com/s3/)
..-S3 uploading provided by [S3.exe](https://s3.codeplex.com/)
- CMS website generation provided by Hugo
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.