↓ Skip to main content
Tina
Tina
  1. Dev Blog/

Blowfish Starter Template – Quick Start Guide

Hugo Blowfish Guide Deployment Blowfish-Starter-Template

Want to get a Blowfish site running instantly?

With this starter template, you can deploy right after creating your repo—no config changes needed.

👉 Repo: https://github.com/mksalada/blowfish-starter-template

mksalada/blowfish-starter-template

Blowfish Starter Template (Hugo)

HTML
0
0

🐡 Blowfish Starter Template
#

⚡ A plug-and-play Hugo + Blowfish starter template that works on GitHub Pages, Netlify, Vercel, Render, and Cloudflare Pages.

Hugo
Blowfish
Deploy

⚡️ Quick Start
#

  1. 👆 Click “Use this template”
  2. 📦 Create your own repository
  3. 🚀 Deploy to your preferred platform:

🌍 Live Demo
#

Check out the live version of this template:

🚀 Deployment Guide
#

This template works across multiple platforms out-of-the-box:

😺 GitHub Pages
#

GitHub Pages

  1. Go to Settings → Pages
  2. Set Source to GitHub Actions
  3. 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.

Tip

Enable automatic theme updates (Optional)
#

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 PRs when Blowfish updates.

☁️ Cloudflare Pages
#

Cloudflare

  1. Create a new project (with Pages, not Workers)
  2. Connect your repository
  3. Set framework to Hugo
    • Build command: hugo
    • Output directory: public
  4. Deploy
Tip

(Optional) Change build command to:

hugo --gc --minify

🐦 Netlify
#

Netlify
Deploy to Netlify

  1. Import your repo
  2. Deploy
Note

The included netlify.toml handles everything automatically.

⚫️ Vercel
#

Vercel
Deploy with Vercel

  1. Import your repo
  2. Deploy
Tip

(Optional) Add an Environment Variable:

HUGO_VERSION=0.155.3

🟢 Render
#

Render

  1. Create a Static Site
  2. Connect your repository
  3. Set build command to:
bash render.sh
Note

The included render.sh handles the build setup.

📁 Project Structure
#

.
├── 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:

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.3 or newer
  • All builds output to the public/ directory
  • 🔧 Designed to work without modifying configuration files
  • 📦 Works on both root domains and project subpaths

✏️ Customize Your Site
#

Head over to Blowfish Documentations: Basic Configuration

🙌 Credits
#

⭐ Support
#

If you found this useful, consider giving this repo a ⭐!

Note

Curious how this was built (from a phone 😅)?

👉 Read the devlog: Building a Blowfish Starter Template