Newsletter
Join the Community
Subscribe to our newsletter for the latest news and updates
Pure static Hugo theme for building website navigation directories, based on WebStack.cc, with search, dark mode, and QR codes.
WebStack Hugo is a pure static Hugo theme for building website navigation directories, converted from the popular WebStack.cc project. It turns a YAML data file into a complete, static link directory with search and dark mode, and is open source on GitHub.
WebStack Hugo is a Hugo theme that replicates the WebStack directory layout as a fully static site. It takes a list of categorized links from the data/webstack.yml file and renders them into a browsable navigation page. Built for the Hugo static site generator, it produces plain HTML/CSS/JS with no server-side database or backend. The project is an open source effort based on WebStack.cc and offers two releases: a classic v1.0 and an updated v2.0.
data/webstack.yml file, making the site easy to edit with a text editor and rebuild with Hugo.qrcode field to display a QR code image for mobile scanning, configurable per item.[params.search] setting in config.toml.[params.darkmode] flag in the config file.exampleSite directory with a ready configuration; you copy its contents into your Hugo root and start editing.WebStack Hugo is aimed at anyone who wants a clean, static website for collecting and organizing links. Web developers can use it as a starting point for a personal bookmark manager or a team resource hub. Bloggers and businesses can turn it into a simple "useful links" or "partners" page without installing a database. Because it is pure static, it is also a good choice for hosting on free static hosts such as GitHub Pages or Netlify (though these specific hosts are not mentioned in the project).
The workflow is straightforward. First, install the theme into your Hugo site. Next, copy the files from the exampleSite directory to your Hugo root. Then, edit the data/webstack.yml file to change your links and categories. Finally, run Hugo to generate the static site. The v2.0 version also lets you turn on search and dark mode by setting enable = true inside the [params.search] and [params.darkmode] blocks in config.toml.
The original static WebStack.cc project is the foundation of this theme, and there is also a WordPress version of WebStack by owen0o0 that brings dynamic features like a database and admin panel. If you prefer a WordPress-based solution, that theme may suit you better than the static Hugo approach.
WebStack Hugo is an open source project. The theme itself is free to download, modify, and use; there is no mention of commercial licensing or paid plans on the page.
Yes, the project is described as an open source theme, which means you can download, modify, and use it without a license fee.
If you are coming from v1.0, you need to replace linecons with fa in every icon: value inside webstack.yml. For example, change icon: linecons-star to icon: fa-star.
Yes. In config.toml, under [params.search], set enable = false and rebuild your site with Hugo.
No. It is a pure static Hugo theme, so it only outputs static HTML files. Your navigation data is stored in a YAML file, not in a database.
v2.0 adds an aggregated search box, dark mode, and QR code support, and it uses Font Awesome 4.7.0 icons instead of the older icon set. v1.0 is the original release with the basic WebStack layout.
