Minimal, responsive dark theme with a black-gray background and green text
Waffles — Hugo Blog Template
By UncleSocks
Waffles is a minimal, responsive dark Hugo blog theme created for CyBlog, with a color scheme inspired by hacker terminal aesthetics and influenced by the Risotto theme.
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.
Pure HTML/CSS implementation, without JavaScript or frameworks
Supports tags, an About page, and Font Awesome icons
Influenced by the Risotto Hugo theme, created for CyBlog
Provides an exampleSite sample site and MIT license
Template Details
Waffles is a Hugo blog theme created by the author for their personal site CyBlog. The theme uses a minimal, responsive dark design, with colors drawn from the familiar "hacker" terminal look: a black-gray background paired with green text. According to the README, its design is influenced by the Risotto Hugo theme, and its name comes from the author's Shih Tzu.
The current version is fairly basic and suits simple blog posts on hacking or cybersecurity topics. The theme uses pure HTML/CSS and does not rely on JavaScript or frameworks; pages adapt to different screen sizes, including phones; it supports a favicon (Font Awesome), tags, and an About page.
Installation involves cloning or downloading the repository into the Hugo site's themes directory, then setting theme = 'waffles' in hugo.toml or hugo.yaml. Menu, site title, description, and copyright information can be modified in the configuration file, and the exampleSite directory provides a sample site for reference. The README marks the theme status as "Under Development," indicating that features are still being developed.
Is it right for your project?
Use Cases
- Building a simple Hugo blog on hacking or cybersecurity topics
- Needing a lightweight blog theme with no JavaScript and pure HTML/CSS
- A personal site where menus, title, description, and copyright need quick configuration
- Learning basic Hugo theme configuration by referring to exampleSite
Suitable For
- Personal bloggers using Hugo who prefer a dark, minimal style
- Content creators interested in hacker terminal color schemes
- Developers who want to avoid JavaScript and front-end frameworks
- Simple blog sites that need tags and an About page
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
First create a Hugo site, then clone or copy the repository into the themes directory
- 2
Set theme = 'waffles' in hugo.toml, or theme: waffles in hugo.yaml
- 3
If downloaded as a ZIP, you may need to rename the directory to waffles
- 4
Menus, site title, description, and copyright can be modified in hugo.toml or hugo.yaml
- 5
Refer to the sample site in the exampleSite directory for configuration
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 mean 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
- 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
https://github.com/UncleSocks/Waffles/blob/main/LICENSE.mdhttps://github.com/UncleSocks/Waffles/blob/main/README.mdPermission is hereby granted, free of charge
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-12. 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 · 70 / 100
- Technologies
- Hugo · HTML
- Website type
- Blog
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-05-21
- Screenshot last checked
- 2026-10-12
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.
Review declaration: [email protected] · 2026-10-13
Inspect the recorded source material
SHA-256: 5b492eebc355b105c099c6ccdfee0bb29c30f8a606de4ef98820d95833ac7f48
2026-10-12T14:29:07.729Z
Source file / repository # Waffles: A Hugo Theme for CyBlog    Waffles 🧇 is a minimal and responsive dark Hugo theme created for my CyBlog website. The colorway takes inspiration from the cliché "hacking" computer terminal look — a black/grey background with green text. The theme is named after our Shih Tzu, Waffle, or "fifi" for short, and was heavily influenced by the Risotto Hugo theme.  ## Features The current theme version only has basic features -- perfect for simple blog posts inspired by hacking or cybersecurity. In addition to blog posting, it supports the following: - Plain HTML/CSS, no JavaScript and frameworks - Responsive to different screen sizes, including mobile phones. - Favicons support (Font Awesome) - Tags support - About page ## Installation After creating your Hugo site, download or Git Clone this repository and copy the directory to the site's `themes` directory using the following command: ``` git clone https://github.com/UncleSocks/waffles-hugo-theme-for-cyblog themes/waffles ``` ### Configuration Then, configure the Hugo site to use the Waffles theme by adding `theme = 'waffles'` to the `hugo.toml` file or `theme: waffles` to the `hugo.yaml` file. Note that if you downloaded the theme (i.e., via ZIP download), you may need to rename the directory to "waffles" before modifying the configuration file. ## Theme Modification In addition to the listed features above, you can modify the theme's menu, site's title, description, and copyright on the `hugo.toml` or `hugo.yaml` file. A sample site is available in the `exampleSite` directory for reference.
Explore similar templates
Compare previews and descriptions within the same stack and category.

hugo-PaperMod
A fast, clean, responsive Hugo theme for blogs and lightweight portfolios, with three layout modes (Regular, Home-Info, Profile), automatic and manual light/dark themes, Fuse.js client-side search, multilingual support, and built-in Open Graph, Twitter Cards, and Schema.org data.
Hugo · Portfolio

LoveIt
LoveIt is a clean, elegant, and feature-rich Hugo blog theme derived from LeaveIt and KeepIt, MIT-licensed. It offers light/dark modes, responsive layout, multilingual support, and search via Lunr.js or Algolia.
Hugo · Blog

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

blowfish
Blowfish is a Hugo personal website and blog theme built with Tailwind CSS 4, focused on lightness, simplicity, and content-first presentation.
Hugo · Blog

hugo-paper
hugo-paper is a simple, clean, and customizable Hugo blog theme configured through config.toml or hugo.toml.
Hugo · Blog

hextra
Hextra is a Hugo theme for documentation and blog sites, built on Hugo and Tailwind CSS with design referencing Nextra.
Hugo · Documentation
