⚡ A plug-and-play Hugo + Blowfish starter template that works on GitHub Pages, Netlify, Vercel, Render, and Cloudflare Pages.
- 👆 Click "Use this template"
- 📦 Create your own repository
- 🚀 Deploy to your preferred platform:
Check out the live version of this template:
- Demo 👉 blowfish-starter-template.netlify.app
- Status 🫴
This template works across multiple platforms out-of-the-box:
- Go to Settings → Pages
- Set Source to GitHub Actions
- Push (or re-run workflow)
Your site will be live at: https://<your-username>.github.io/<repo-name>
Note
The workflow in gh-pages.yml will automatically build and deploy your site.
Disable/Delete it if you're not deploying with GitHub Pages.
Tip
Go to Settings → Actions → General and enable:
- Read and write permissions
- Allow GitHub Actions to create and approve pull requests
This enables update-blowfish.yml to create Pull Requests when Blowfish updates.
Disable/delete it if you don't want Blowfish update
- Create a new project (with Pages, not Workers)
- Connect your repository
- Set framework to Hugo
- Build command:
hugo - Output directory:
public
- Build command:
- Deploy
Tip
(Optional) Change build command to:
hugo --gc --minify
- Import your repo
- Deploy
Note
The included netlify.toml handles everything automatically.
Delete it if you're not deploying to Netlify.
- Import your repo
- Deploy
Tip
(Optional) Add an Environment Variable:
HUGO_VERSION=0.155.3
- Create a Static Site
- Connect your repository
- Set build command to:
bash render.sh
.
├── config/_default/ # Hugo configuration
├── content/ # Site content
├── themes/blowfish/ # Blowfish theme
├── render.sh # Render build script
├── netlify.toml # Netlify config
└── .github/workflows/ # GitHub Actions
This template already includes:
- ⚙️ Pre-configured
config/_default - 📍 A ready homepage (
content/_index.md)
So your site:
- ⚡️ Builds immediately
- 🚀 Doesn’t break on first deploy
- 🔧 Requires no initial setup
Important
- Blowfish requires Hugo Extended for SCSS support
- Recommended version:
0.155.3or newer
- Recommended version:
- All builds output to the
public/directory - 🔧 Designed to work without modifying configuration files
- 📦 Works on both root domains and project subpaths
Head over to Blowfish Documentations: Basic Configuration
- Hugo Static Site Generator
- Blowfish Theme by Nuno Coracao
If you found this useful, consider giving this repo a ⭐!
Note
This template is a non-CLI/terminal alternative to install and deploy Blowfish. If you want to install Blowfish via CLI/terminal on your local machine, see Blowfish Installation.
Curious how this was built from a phone? 😅
👉 Read the devlog: Building a Blowfish Starter Template