A minimalist retro theme for Hugo, MIT licensed
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.
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.
What stands out
A quick read of the recorded project description.
No script dependencies, aiming for few dependencies and easy maintenance
Site configuration items to replace are marked with a TK prefix in config.toml
Page-level fields such as streamtitle, timeless, and coolinthe80slastmod are provided through an archetype
CSS is based on HTML5 Boilerplate and normalize.css, with custom styles prefixed whbcit8
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.
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
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
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
aboutpage must be the filename of the about page without extension, otherwise the header about link will not work
- 4
To add a homepage introduction, create a Markdown document in the content directory with frontmatter timeless = "indexintro" and title = "indexintro"
- 5
Page frontmatter can use fields such as streamtitle, timeless, and coolinthe80slastmod (YYYYMMDD); coolinthe80slastmod is entered manually and is not automatically formatted
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis 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
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.mdyou need hugo to use this theme
Original README
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 / repositorywould 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  ## 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
Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-coder
hugo-coder is a minimalist Hugo blog theme maintained by luizdepra under the MIT license. It provides a clean, text-focused blog appearance, configuration documentation in the docs directory, and a complete exampleSite with hugo.toml.
Hugo · Blog

doks
Doks is a Hugo documentation theme in the Thulite ecosystem, built for long-form reading with a minimal responsive layout and documentation-optimized typography. It includes FlexSearch-powered configurable search, dark/light mode, code syntax highlighting, i18n, multi-version documentation management, and blog pages.
Hugo · Tool Site

hugo-theme-introduction
Introduction is a minimal Hugo theme that can be configured as a single-page site or a full site with multiple sections. Homepage sections are generated from Markdown files under content/home/, with weight sorting and optional images.
Hugo · Portfolio

lotusdocs
Lotus Docs is a free, MIT-licensed Hugo documentation theme by Colin Wilson, built on Bootstrap 5. It provides responsive documentation layouts, dark mode, i18n, FlexSearch-based static search, Prism.js highlighting, KaTeX, Mermaid, and landing page templates.
Hugo · Documentation

airspace-hugo
Airspace is a multipurpose Hugo theme by Themefisher for portfolio, blog, and business sites.
Hugo · Portfolio

kross-hugo
Kross is a Hugo personal portfolio theme by Themefisher, offering more than 8 pre-built pages including home, about, blog, portfolio, and contact.
Hugo · Portfolio
