A minimalist Bootstrap-based Hugo blog theme
HugoHTMLBlog
hugo-minimal — Hugo Blog Template
By ZhongRuoyu
A minimalist Bootstrap-based Hugo blog theme that can be added to a site as a Git submodule or Hugo Module.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
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.
A follow-up to the author's Jekyll theme of the same name
Supports adding to a Hugo site as a Git submodule
Supports importing and installing as a Hugo Module
Provides an online demo site and demo repository
The repository uses a standard MIT license
Template Details
Minimal is a minimalist Bootstrap-based Hugo blog theme positioned as simple and extensible, and is a follow-up to the author's Jekyll theme of the same name. The theme uses Hugo and HTML as its main stack and is suited to blog sites centered on post lists and article reading.
There are two ways to use it: add it to an existing Hugo site as a Git submodule, or import it in hugo.toml as a Hugo Module and install it by running hugo mod get. The repository provides an online demo site and a corresponding demo repository for comparing actual page results.
Regarding licensing, the repository includes a standard MIT license file, permitting free use, modification, commercial use, and distribution of this version of the code; when distributing copies or substantial portions of the code, the original author's copyright notice and the full MIT license notice must be retained. Third-party assets such as demo images, fonts, and icons, as well as external services such as domains and hosting, are not covered by this license and must be checked separately or paid for.
HugoHTMLBlog
Is it right for your project?
Use Cases
- Building a personal blog centered on post lists and article reading
- Replacing or adding a minimalist theme in an existing Hugo site
- Hugo projects that need to manage theme versions as a Git submodule
- Hugo projects that need to import the theme as a Hugo Module
Suitable For
- Developers building blogs with Hugo
- Site maintainers who prefer a Bootstrap-based style foundation
- Users who want simple theme code that is easy to extend themselves
- Users who accept the MIT license terms and need to retain the copyright notice
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
As a Git submodule: run git submodule add https://github.com/ZhongRuoyu/hugo-minimal.git themes/minimal, and set theme = "minimal" in hugo.toml
- 2
As a Hugo Module: first run hugo mod init github.com/<user>/<repo>, set theme to the repository path in hugo.toml and add module.imports, then run hugo mod get
- 3
Third-party assets such as demo images, fonts, and icons must be checked separately under their respective licenses
- 4
External services such as domains and hosting may incur additional costs
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party assets are free.
Must comply with when using
- Free use, modification, commercial use, and distribution of this version of the 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 under 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/ZhongRuoyu/hugo-minimal/blob/main/LICENSEhttps://github.com/ZhongRuoyu/hugo-minimal/blob/main/README.mdPermission is hereby granted, free of charge
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
- GitHub
- Documentation and maintenance reference score
- More documented · 77 / 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
- 2026-09-07
- 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: 2fcdfca2831be902561ba112c7ae3351603e45bc7fac2766795511c04a5ee64f
2026-10-03T21:19:40.875Z
Source file / repository# Minimal Minimal is a simple, extensible [Bootstrap](https://getbootstrap.com/)-based minimalist [Hugo](https://gohugo.io/) blog theme. It is the successor of [a same-named theme for Jekyll](https://github.com/ZhongRuoyu/jekyll-minimal). ## Usage To use this theme, you can use one of the following methods. ### As a Git Submodule 1. Add the theme as a submodule to your Git-managed Hugo site: ```bash git submodule add https://github.com/ZhongRuoyu/hugo-minimal.git themes/minimal ``` 2. Add the theme to your `hugo.toml`: ```toml theme = "minimal" ``` ### As a Hugo Module 1. Initialize your site as a Hugo module (if not already done): ```bash hugo mod init github.com/<user>/<repo> ``` 2. Add the theme to your `hugo.toml`: ```toml theme = "github.com/ZhongRuoyu/hugo-minimal" [module] [[module.imports]] path = "github.com/ZhongRuoyu/hugo-minimal" ``` 3. Install the Hugo module: ```bash hugo mod get ``` ## Live Demo A live demo is available at <https://minimal.ruoyu.io> ([GitHub repository](https://github.com/ZhongRuoyu/hugo-minimal-demo)). ## License Minimal is licensed under [MIT License](LICENSE).
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