Bootstrap-based Hugo startpage theme that generates a complete single-page site rather than rendering entries on demand
HugoHTMLStarter
bootstrap-bp-hugo-startpage — Hugo Starter Template
By spech66
A Bootstrap-based Hugo startpage theme that renders link groups into a complete single-page site, with a built-in search box and Font Awesome icon support.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
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.
Link data centralized in data/links.yml, grouped by group, with each item containing title, url, and icon
Built-in search box, with search engines enabled or added via params.searchEngines, and support for custom query parameter names
Set the text above the search box via welcomeText, and toggle grouped list display via startPageColumns
Icons use Font Awesome icon class names
MIT license, allowing free use, modification, commercial use, and distribution
Template Details
Bootstrap-BP hugo startpage is a Hugo theme developed by Sebastian Pech, positioned as a browser startpage. It combines the author's Bootstrap-BP Hugo theme with the startpage project; unlike the latter, which renders entries on demand, this theme generates a complete single-page site.
For usage, link data is placed in data/links.yml, grouped by group, with each item containing title, url, and icon fields, where icons come from Font Awesome. Theme settings follow Hugo's own variables as much as possible, adding only a few optional parameters: welcomeText controls the text above the search box, and startPageColumns determines whether the startpage displays as a grouped list. The search box supports configuring multiple search engines, declared via the params.searchEngines array with name, activated, and url; individual engines can additionally specify searchkey (e.g., Baidu uses kw).
Installation involves creating a themes folder in the Hugo site directory and git cloning the repository, or downloading a zip and extracting it to the themes directory. The repository is released under the MIT license, allowing free use, modification, commercial use, and distribution of the code; however, third-party assets such as background images must be checked separately under their respective licenses.
HugoHTMLStartpage
Is it right for your project?
Use Cases
- Build a personal browser startpage to display frequently used sites grouped by categories such as social and tools
- Provide a search box at the top of the startpage and switch between engines like Google, DuckDuckGo, Bing, and Baidu
- Enable startPageColumns when you need to browse links as a grouped list rather than a flat display
- Use as a Hugo site, maintaining link content via data/links.yml without modifying template code
Suitable For
- Developers using Hugo who want to quickly set up a personal startpage
- Users who prefer maintaining bookmark links via YAML data files and do not want to hand-write HTML
- Startpage scenarios requiring a multi-search-engine switch entry
- Projects that accept Bootstrap and Font Awesome front-end dependencies
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
In the Hugo site directory, run mkdir themes && cd themes && git clone https://github.com/spech66/bootstrap-bp-hugo-startpage.git, or download the zip and extract it to the themes directory
- 2
Define links in data/links.yml using the group and items structure, with each item providing title, url, and icon
- 3
Enable search engines in the configuration via the params.searchEngines array, specifying searchkey for engines when necessary
- 4
Optional parameters: welcomeText sets the text above the search box, startPageColumns controls whether to display as a grouped list
- 5
Third-party assets such as background images must be checked separately under their respective licenses, and cannot be judged solely based on the code's MIT license
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 applies to that version's code 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 that 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
- Icons use Font Awesome icon class names; Font Awesome is a third-party resource whose license is independent of the code's MIT license, and its terms must be checked separately.
- The background image used by the theme comes from third-party author Mikael Gustafsson and is separately licensed material not covered by the MIT code license; its authorization must be confirmed separately before commercial use or redistribution.
- Demo images, fonts, icons, and other third-party assets must be checked under their respective licenses and cannot be judged solely based on the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur additional charges.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
Icons are taken from [Font Awesome](https://fontawesome.com/icons?d=gallery).
Original README
https://github.com/spech66/bootstrap-bp-hugo-startpage/blob/master/LICENSEhttps://github.com/spech66/bootstrap-bp-hugo-startpage/blob/master/README.md* Background image by [Mikael Gustafsson](https://www.artstation.com/artwork/Y2Wew)
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
- Hugo Themes
- Documentation and maintenance reference score
- More documented · 80 / 100
- Technologies
- Hugo · HTML
- Website type
- Starter
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-07-18
- 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: b95f721bb7baccd70b633ec3e12908b983485e5dbf2435f7ffaa034f6dca4939
2026-10-03T05:04:31.915Z
Source file / repository# Bootstrap-BP hugo startpage
Bootstrap based Hugo startpage theme which provides out of the box best practices.
This theme is a combination of my [Bootstrap-BP hugo theme](https://github.com/spech66/bootstrap-bp-hugo-theme) and my [startpage](https://github.com/spech66/startpage).
Instead of rendering the items on-the-fly as in the startpage theme the **Bootstrap-BP hugo startpage** will generate a complete single page site.
Other themes by Sebastian Pech: [Bootstrap-BP](https://github.com/spech66/bootstrap-bp-hugo-theme), [Materialize-BP](https://github.com/spech66/materialize-bp-hugo-theme),
[Bootstrap-BP hugo startpage](https://github.com/spech66/bootstrap-bp-hugo-startpage).
## Install the theme
With Git installed, run the following commands inside the Hugo site folder. If Hugo has not yet been installed, read the setup guide [here](https://gohugo.io/getting-started/quick-start/).
```sh
mkdir themes
cd themes
git clone https://github.com/spech66/bootstrap-bp-hugo-startpage.git
```
You can get a zip of the latest version of the theme from the [home page](https://github.com/spech66/bootstrap-bp-hugo-theme) and extract it to the themes folder.
## Theme settings
Most settings should be done with hugo specific variables. There are only a few (optional) additional `[params]`.
* `welcomeText = "Startpage!"` is the text above the search box
* `startPageColumns = true` will show the start page in grouped lists
Activate the search engine you want to use (or add a new one).
```toml
[[params.searchEngines]]
name = "Google"
activated = true
url = "https://www.google.com/search"
[[params.searchEngines]]
name = "DuckDuckGo"
activated = true
url = "https://duckduckgo.com/"
[[params.searchEngines]]
name = "Bing"
activated = true
url = "https://www.bing.com/search"
[[params.searchEngines]]
name = "Baidu"
activated = true
url = "https://baidu.com/"
searchkey = "kw"
```
Define the links in a file in `data/links.yml`. This needs to be structured like this.
```yml
---
- group: Social media
items:
- title: reddit
url: https://www.reddit.com
icon: fab fa-reddit
- title: Facebook
url: https://www.facebook.com
icon: fab fa-facebook
- group: Utilities
items:
- title: GitHub
url: https://www.github.com
icon: fab fa-github
```
Icons are taken from [Font Awesome](https://fontawesome.com/icons?d=gallery).
## Sources
* Background image by [Mikael Gustafsson](https://www.artstation.com/artwork/Y2Wew)
Inspired by:
* [Reddit - r/startpages](https://www.reddit.com/r/startpages/)
* [Github - 0-Tikaro - Minimum Viable Startpage](https://github.com/0-Tikaro/minimum-viable-startpage), Searchbox code
* [Github - ViktorKare - startpage](https://github.com/ViktorKare/startpage)
Explore similar templates
Compare previews and descriptions within the same stack and category.
hugo-xmin
hugo-xmin is an extremely minimal Hugo theme written by Yihui Xie for template beginners. HTML and CSS total about 140 lines, with no external dependencies, and it uses the MIT license.
Hugo · Starter
hugo-theme-gallery
A Hugo Extended photo gallery theme that organizes images with Page Bundles, automatically generating album lists and gallery pages with a Justified layout and PhotoSwipe lightbox.
Hugo · Starter
reveal-hugo
reveal-hugo is a Hugo theme that converts Markdown content into Reveal.js-based HTML presentations. It supports slide separation with `---`, shortcodes for fragments, slides, sections, notes, Markdown, and MathJax, and organizes content as root or section presentations with order controlled by weight.
Hugo · Starter
anatole
Anatole is a minimalistic two-column Hugo theme ported from farbox-theme-Anatole, featuring dark mode, multilingual and RTL support, and optional portfolio, comments, analytics, KaTeX, and Mermaid integrations. It suits personal blogs, portfolios, or documentation sites built with Hugo.
Hugo · Starter
hugo-theme-diary
A Hugo diary-style theme ported from the Hexo theme Journal, with a grid homepage for essays and daily notes. It supports six languages, dark mode, table-of-contents scroll positioning, reading time, code highlighting, and configurable sidebar, fonts, and colors.
Hugo · Starter
risotto
risotto is a minimalist, responsive Hugo theme inspired by terminal ricing aesthetics. It uses semantic HTML and pure CSS with no JavaScript, and its layout relies on CSS Grid for native responsiveness without manual breakpoints.
Hugo · Starter