Hugo blog theme built with Bootstrap 5
hugo-bootstrap-5 — Hugo Blog Template
By NotWoods
A simple Hugo blog theme based on Bootstrap 5, supporting multilingual and menu configuration, under the MIT license.
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.
Navigation bar renders Hugo's main menu by default
Supports multilingual, with i18n including English and Spanish translations by default
Brand area can be replaced by overriding the brand.html partial template
exampleSite provides config.toml and brand template examples
Installed and updated as a git submodule
Template Details
hugo-bootstrap-5 is a Hugo blog theme built with Bootstrap 5, and the author states it was inspired by hugo-bootstrap. The theme is positioned as simple and suitable as a starting point for a personal blog or content site.
In terms of functionality, the theme renders the main menu in the navigation bar through Hugo's menu template; it supports multilingual, with the i18n directory providing English and Spanish translation packages by default; the brand area can be replaced by overriding layouts/partials/brand.html. The repository's exampleSite directory provides a config.toml configuration example and a brand partial template example for reference when setting up.
Installation is done by adding the repository as a git submodule to the Hugo site's themes/hugo-bootstrap-5 directory, and theme updates can then be obtained by updating the submodule. The README does not elaborate on specific features such as article lists, pagination, SEO, or comments, so it is recommended to check against the exampleSite and actual needs before use.
Is it right for your project?
Use Cases
- Building a personal blog with Hugo and wanting to use Bootstrap 5 styling
- Needing a multilingual blog with default translations including English and Spanish
- Wanting to customize the site brand area by overriding a partial template
- Managing the theme as a git submodule and updating it with upstream
Suitable For
- Developers familiar with Hugo's directory structure and configuration
- Bloggers who accept Bootstrap 5's default visual style
- Multilingual sites needing an English or Spanish interface
- Users who want to use and modify the theme code under the MIT license
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
In the Hugo site root, run git submodule add https://github.com/NotWoods/hugo-bootstrap-5.git themes/hugo-bootstrap-5, and initialize and update the submodule.
- 2
Configure the site by referring to exampleSite/config.toml; the menu needs to be set up as the main menu following Hugo's menu template approach.
- 3
To replace the brand area, create layouts/partials/brand.html in the site; you can refer to exampleSite/layouts/partials/brand.html.
- 4
Multilingual translation packages are located in the theme's i18n directory, providing English and Spanish by default.
- 5
Third-party assets such as demo images, fonts, and icons need to be checked separately under their respective licenses.
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 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 allowed.
- 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 need to 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 additional charges.
View Original Text Basis
https://github.com/NotWoods/hugo-bootstrap-5/blob/main/LICENSE.mdhttps://github.com/NotWoods/hugo-bootstrap-5/blob/main/README.mdPermission is hereby granted, free of charge
Original License Text
Compiled by DeepSeek based on repository license and README ·2026-10-02. 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 · 65 / 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
- 2022-03-26
- Screenshot last checked
- 2026-10-02
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: 675fb4b108e9756bda2d7a78da74ea44c64e3bce3014f9c20794414d00a2531e
2026-10-02T10:10:19.977Z
Source file / repository# Hugo Bootstrap v5 Theme This is a simple Hugo theme using [Bootstrap v5](https://getbootstrap.com/), inspired by [hugo-bootstrap](https://github.com/Xzya/hugo-bootstrap). ## Installation You can install the theme either as a clone or submodule. I recommend the latter. From the root of your Hugo site, type the following: ```shell $ git submodule add https://github.com/NotWoods/hugo-bootstrap-5.git themes/hugo-bootstrap-5 $ git submodule init $ git submodule update ``` Now you can get updates to the theme in the future by updating the submodule: ``` $ git submodule update --remote themes/hugo-bootstrap-5 ``` ## Demo You can find a demo [here](https://themes.gohugo.io/theme/hugo-bootstrap-5/). ## Screenshots   ## Configuration Check `exampleSite/config.toml` for an example configuration. ## Brand The brand can be overriden by adding your own layout `layouts/partials/brand.html`. Check `exampleSite/layouts/partials/brand.html` for an example. ## Menu The navbar displays the `main` menus by default. You can find more details about how to configure it [here](https://gohugo.io/templates/menu-templates/), as well as in the `exampleSite`. ## Multilanguage The theme supports multiple languages. You can find the default translation bundles in `i18n` (english and spanish by default). ## License Open sourced under the [MIT license](./LICENSE.md).
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
