Hugo Theme Bootstrap Skeleton

Hugo Theme Bootstrap Skeleton is a starter template for the Hugo Bootstrap Theme that installs the theme as a Hugo module, giving you a pre-configured Hugo site with Bootstrap styling.

What is Hugo Theme Bootstrap Skeleton?

Hugo Theme Bootstrap Skeleton is a starter template for Hugo Bootstrap Theme, a Hugo theme based on the Bootstrap CSS framework. It installs the theme as a Hugo module via a go.mod file, so a new site pulls the theme without vendoring the source. The template includes configuration files under config/_default, example layout hooks, and deployment workflows for GitHub Pages, Netlify, and Docker. It is maintained by razonyang and runs on Hugo, the static site generator.

Key Features

• Hugo module installation — The theme is installed as a Hugo module through go.mod, making upgrades a single hugo mod get command.
• Docker-based development — Includes a Dockerfile and docker-compose setup; run docker compose run server npm ci then docker compose up to develop without installing Hugo or Node locally.
• Multiple deployment targets — Ships with a GitHub Pages workflow (.github/workflows/gh-pages.yml) and supports Netlify and Cloudflare Pages out of the box.
• Config directory structure — Configuration lives in config/_default/config.yaml; the baseURL must be set there for correct CSS, JS, and sitemap generation.
• Customization hooks — The layouts/partials/hooks folder demonstrates how to inject content via partials, and can be deleted if unused.
• Comment system config — Ready to configure utterances.* or giscus.* parameters for GitHub-based comments.
• Optional Go proxy — For users in mainland China, the template documents setting HUGO_MODULE_PROXY to goproxy.cn or goproxy.io to avoid module download failures.
• Multi-language documentation — The starter links to English, Simplified Chinese, and Traditional Chinese docs for the theme.

Who is it for?

• Hugo developers — start a new Bootstrap-themed site with a working configuration and deployment pipeline instead of wiring the theme manually.
• Developers in mainland China — follow the documented Go proxy setup to reliably download the theme module without a VPN.
• Teams using Docker — use the docker-compose workflow to give every contributor the same local environment without installing Hugo or npm.

Use cases

• Bloggers and content sites: Use the skeleton to publish a Hugo site with the Bootstrap theme on GitHub Pages or Netlify, including the provided deploy workflow.
• Documentation projects: Set up a multi-language documentation site by leveraging the theme's translation support and the starter's configuration structure.
• Developers testing themes: Clone the skeleton to experiment with the Hugo Bootstrap Theme's features and layout hooks without affecting an existing site.

How does it work?

The workflow is: clone the repository (or use GitHub's "Use this template" button), edit go.mod to change the module path to your repo, then commit and push. For local development, either run Docker Compose or install dependencies with npm ci and start hugo server. To upgrade the theme, run hugo mod get github.com/razonyang/hugo-theme-bootstrap@master, then hugo mod npm pack and npm update.

FAQ

Is Hugo Theme Bootstrap Skeleton free?

Since it's a GitHub repository with no listed price, it's free to use and modify. The template doesn't state a license, so you should check the repository for licensing details.

How do I deploy to GitHub Pages?

The template includes a GitHub Actions workflow at .github/workflows/gh-pages.yml. After setting your baseURL in config/_default/config.yaml, push the repository to GitHub and enable GitHub Pages. You may need to remove the -b {url} flag from the workflow.

Do I need to install Hugo?

If you use the Docker Compose workflow, no local Hugo or Node installation is required. Otherwise, you need the build tools (Hugo and npm) installed and run npm ci then hugo server.

How do I upgrade the theme?

Run hugo mod get github.com/razonyang/hugo-theme-bootstrap@master (or a stable release tag), then hugo mod npm pack and npm update. Commit the updated go.mod, go.sum, package.json, and package-lock.json.

How do I change the Go module proxy?

Set the environment variable HUGO_MODULE_PROXY to https://goproxy.cn or https://goproxy.io, or configure module.proxy in your Hugo config. Hugo does not respect the GOPROXY environment variable.