Loads the hugo-theme-stack theme via Hugo Modules, keeping only the site structure and configuration in the repository
HugoBlog
blog-stack — Hugo Blog Template
By gavinblog
A quick-start blog template based on Hugo and hugo-theme-stack, loading the theme via Hugo Modules and preconfigured with 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.
Desktop homepage1 / 2
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-03View source
What stands out
A quick read of the recorded project description.
Preconfigured GitHub Actions workflow that automatically deploys to the repository's GitHub Pages after pushing
Includes a scheduled task to update the theme daily
Supports GitHub Codespaces, with Hugo extended already configured, allowing direct running of hugo server
Site configuration is centralized in the config directory, and parameters like baseurl can be modified as needed
Template Details
This is a quick-start blog template for Hugo that loads the hugo-theme-stack theme via Hugo Modules, with the repository containing only the basic site structure and configuration files. The template includes a preconfigured GitHub Actions workflow that automatically deploys the site to the repository's corresponding GitHub Pages, along with a scheduled task to update the theme daily.
For usage, the README recommends creating a repository via GitHub's Use this template, then opening it with GitHub Codespaces: the codespace already has Hugo extended configured, so running hugo server provides local preview. Site configuration is centralized in the config directory, where the baseurl in config/_default/config.toml must be changed to your own site address; after editing, commit and push, and GitHub Actions will handle deployment automatically.
If not using Codespaces, you can also run locally, but you need to install Git, Go, and Hugo extended yourself. Theme updates require manually running hugo mod get -u and hugo mod tidy; due to Go module limitations, the template is pinned to theme v3, and upgrading to future major versions requires modifying config/module.toml manually. When deploying to other static hosting platforms, ensure the build environment has Go installed; the README provides an example for Vercel by overriding the build command and setting the HUGO_VERSION environment variable.
HugoBlog
Is it right for your project?
Use Cases
- Quickly create a blog repository using hugo-theme-stack on GitHub
- Edit and preview a Hugo site in the browser via GitHub Codespaces
- Automatically publish a static blog to GitHub Pages
- Run and build the site locally after installing Git, Go, and Hugo extended
Suitable For
- Developers who want to build a personal blog with Hugo and hugo-theme-stack
- Users who prefer managing site source code and deployment via GitHub repositories and Actions
- Those who need a ready-to-modify blog starter structure with configurable settings and replaceable content
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
Click Use this template on GitHub to create your own repository, or clone the template directly
- 2
When using Codespaces, Hugo extended is already installed, so running hugo server provides preview
- 3
Local running requires installing Git, Go, and Hugo extended yourself
- 4
Change the baseurl in config/_default/config.toml to your actual site address
- 5
When deploying to other static hosts like Vercel, ensure the build environment has Go installed and set HUGO_VERSION
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license from 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 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
- Local running 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 hosting platforms, the build environment must have Go installed, otherwise the build cannot complete.
- The template is pinned to theme v3; upgrading to theme v4 or later major versions requires manually modifying config/module.toml.
- Demo images, fonts, icons, and other third-party assets must be checked against 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
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
https://github.com/gavinblog/blog-stack/blob/master/LICENSEhttps://github.com/gavinblog/blog-stack/blob/master/README.mdyou need to update the theme manually. (Modifying `config/module.toml` file)
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 · 65 / 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
- 2023-05-05
- 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: 9261108322fff8e7ab5efe93009deee1f33e16024708cb2482440ed45fa57c83
2026-10-03T21:17:58.766Z
Source file / repository## 博客地址 > https://gavinblog.github.io/blog-stack/ ## 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. To get started: 1. Click *Use this template*, and create your repository on GitHub.  2. Once the repository is created, create a GitHub codespace asociated 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. 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 ```  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