Loads the Stack theme via Hugo Modules; the template itself does not embed the theme source code
HugoBlog
stack-website — Hugo Blog Template
By alekzhang
A quick-start template for the Hugo Stack theme that loads the theme via Hugo Modules and includes GitHub Actions for automatic deployment to GitHub Pages.
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.
Includes GitHub Actions to automatically deploy to GitHub Pages after pushing
Comes with a daily scheduled task to automatically update the referenced theme
Provides basic theme structure and configuration files in the config directory
Supports running `hugo server` for preview directly in GitHub Codespaces
The README explains additional steps for deploying to other static hosts like Vercel
Template Details
This is a quick-start template for the Hugo Stack theme. It does not include the theme's source code; instead, it references and loads the Stack theme through Hugo Modules, and the repository provides the basic theme structure and configuration files.
The template includes GitHub Actions: after pushing a commit, the site is automatically deployed to the GitHub Pages associated with the repository; there is also a scheduled task that automatically updates the theme daily. The README outlines the process: create a repository named `<username>.github.io` from this template, run `hugo server` in the associated GitHub Codespace to preview, modify the configuration in the `config` directory (including `baseurl` in `config/_default/config.toml`), and finally change the build branch from `master` to `gh-pages` in the repository's Settings → Pages.
If not using Codespaces, you can also run locally, but you need to install Git, Go, and Hugo extended yourself. The template is configured for version v3 of the theme; due to Go module limitations, when the theme releases v4 or higher, you need to manually modify `config/module.toml` and run `hugo mod get -u` and `hugo mod tidy` to update. When deploying to other static hosts like Vercel, you need to ensure Go is installed on the build machine and override the build or install commands accordingly, and specify the Hugo version.
HugoBlog
Is it right for your project?
Use Cases
- Quickly set up a personal blog site based on the Stack theme on GitHub
- Host a Hugo site on GitHub Pages and want automatic publishing after commits
- Blog projects that want the theme to automatically upgrade with upstream updates
- Preview and adjust Hugo site configuration in Codespaces or a local environment
Suitable For
- Bloggers using Hugo who want to start with the Stack theme
- Developers accustomed to using GitHub Actions to automatically deploy static sites
- Users who need to host a personal site on GitHub Pages
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Create a repository named `<username>.github.io` from this template and run `hugo server` in the associated Codespace
- 2
Modify the configuration files in the `config` directory and update `baseurl` in `config/_default/config.toml`
- 3
In the repository's Settings → Pages, change the build branch from `master` to `gh-pages`
- 4
To run locally, you need to install Git, Go, and Hugo extended yourself
- 5
When the theme upgrades to v4 or above, manually modify `config/module.toml` and run `hugo mod get -u` and `hugo mod tidy`
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in a 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 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
- Running this template locally requires installing Git, Go, and Hugo extended yourself; the site cannot be built if the environment does not meet these requirements.
- When deploying to other static hosts like Vercel, the build machine must have Go installed, otherwise the build cannot complete.
- After the theme releases v4 or higher, due to Go module limitations, you must manually modify config/module.toml and run update commands; automatic upgrades are not possible.
- When using GitHub Pages, you need to change the build branch from master to gh-pages in the repository settings, otherwise the site will not publish properly.
- Demo images, fonts, icons, and other third-party assets must be checked against their respective licenses; they 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
Permission is hereby granted, free of charge
Original License Text
You need to install Git, Go and Hugo extended locally.
Original README
you need to make sure they have Go installed in the machine
Original README
you need to update the theme manually. (Modifying `config/module.toml` file)
Original README
https://github.com/alekzhang/stack-website/blob/master/LICENSEhttps://github.com/alekzhang/stack-website/blob/master/README.mdChange the build branch from `master` to `gh-pages`.
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
- GitHub
- Documentation and maintenance reference score
- Partly documented · 68 / 100
- Technologies
- Hugo
- 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-03-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.
Review declaration: [email protected] · 2026-10-04
Inspect the recorded source material
SHA-256: 4008f53b2cb7a6a1f1cd97028d220ec8b962f6985a7716352be78012b6cf55fb
2026-10-03T21:23:00.149Z
Source file / repository<img align="right" width="150" alt="logo" src="https://user-images.githubusercontent.com/5889006/190859553-5b229b4f-c476-4cbd-928f-890f5265ca4c.png"> # Hugo Theme Stack Starter Template This is a quick start template for [Hugo theme Stack](https://github.com/CaiJimmy/hugo-theme-stack). It uses [Hugo modules](https://gohugo.io/hugo-modules/) feature to load the theme. It comes with a basic theme structure and configuration. GitHub action has been set up to deploy the theme to a public GitHub page automatically. Also, there's a cron job to update the theme automatically everyday. ## Get started 1. Click *Use this template*, and create your repository as `<username>.github.io` on GitHub.  2. Once the repository is created, create a GitHub codespace associated with it.  3. And voila! You're ready to go. The codespace has been configured with the latest version of Hugo extended, just run `hugo server` in the terminal and see your new site in action. 4. Check `config` folder for the configuration files. You can edit them to suit your needs. Make sure to update the `baseurl` property in `config/_default/config.toml` to your site's URL. 5. Open Settings -> Pages. Change the build branch from `master` to `gh-pages`.  6. Once you're done editing the site, just commit it and push it. GitHub action will deploy the site automatically to GitHub page asociated with the repository.  --- In case you don't want to use GitHub codespace, you can also run this template in your local machine. **You need to install Git, Go and Hugo extended locally.** ## Update theme manually Run: ```bash hugo mod get -u github.com/CaiJimmy/hugo-theme-stack/v3 hugo mod tidy ``` > This starter template has been configured with `v3` version of theme. Due to the limitation of Go module, once the `v4` or up version of theme is released, you need to update the theme manually. (Modifying `config/module.toml` file) ## Deploy to another static page hostings If you want to build this site using another static page hosting, you need to make sure they have Go installed in the machine. <details> <summary>Vercel</summary> You need to overwrite build command to install manually Go: ``` amazon-linux-extras install golang1.11 && hugo --gc --minify ```  If you are using Node.js 20, you need to overwrite the install command to install manually Go: ``` dnf install -y golang ```  Make sure also to specify Hugo version in the environment variable `HUGO_VERSION` (Use the latest version of Hugo extended):  </details>
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