Docs on Blowfish

Welcome to Blowfish

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Blowfish is packed with tons of features.

The original aim of Blowfish was to develop a theme that was simple and lightweight. The theme is a fork of Congo and expands its initial vision.

Installation

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Simply follow the standard Hugo Quick Start procedure to get up and running quickly.

Detailed installation instructions can be found below. Instructions for updating the theme are also available.

Agent skill
#

Blowfish ships an agent skill that teaches AI coding agents — like Claude Code — how to install, configure, and build sites with the theme. If you use an agent to work on your site, install the skill so it knows its way around Blowfish’s configuration files, layouts, front matter, and shortcodes.

Getting Started

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

This section assumes you have already installed the Blowfish theme. Working with an AI coding agent? Blowfish ships an agent skill that teaches agents like Claude Code how to install, configure, and build with the theme — see the installation page to set it up.

The config files that ship with Blowfish contain all of the possible settings that the theme recognises. By default, many of these are commented out but you can simply uncomment them to activate or change a specific feature.

Configuration

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Blowfish is a highly customisable theme and uses some of the latest Hugo features to simplify how it is configured.

The theme ships with a default configuration that gets you up and running with a basic blog or static website.

Homepage Layout

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Blowfish provides flexible homepage layouts with settings to adjust each design. Alternatively, you can also provide your own template and have complete control over the homepage content.

The layout of the homepage is controlled by the homepage.layout setting in the params.toml configuration file. Additionally, all layouts have the option to include a listing of recent articles.

Shortcodes

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

In addition to all the default Hugo shortcodes, Blowfish adds a few extras for additional functionality.

Accordion
#

accordion creates a collapsible set of panels. Use the accordionItem sub-shortcode to define each item. You can control whether multiple items can be open at the same time using the mode parameter.

Front Matter

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

In addition to the default Hugo front matter parameters, Blowfish adds a number of additional options to customise the presentation of individual articles. All the available theme front matter parameters are listed below.

Multiple Authors

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Some websites have more than one author contributing with content and therefore require more than a single default author across the entire website. For those use-cases, Blowfish allows users to extend the list of authors using the multiple authors feature.

Partials

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Analytics
#

Blowfish provides built-in support for Fathom Analytics, Google Analytics and Umami Analytics. Fathom is a paid alternative to Google Analytics that respects user privacy.

Thumbnails

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Thumbnails
#

Blowfish was enhanced in order to make it easy to add visual support to your posts. To do so, you just need to place an image file (almost all formats are supported but we recommend .png or .jpg) that starts with feature* inside your article’s main directory, as shown in the example below.

Series

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

Blowfish provides a feature to group a set of articles together under a “series”. Placing an article under a series will display the rest of the series articles in each single page and provide a quick way to navigate amongst them. You can see an example of this above.

Advanced Customisation

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

There are many ways you can make advanced changes to Blowfish. Read below to learn more about what can be customised and the best way of achieving your desired result.

Hosting & Deployment

nuno@n9o.xyz (Blowfish) — Mon, 01 Jan 0001 00:00:00 +0000

There are many ways to deploy your Hugo website built with Blowfish. The theme is designed to be flexible in almost any deployment scenario.

Blowfish is built using relative URLs throughout the theme. This enables sites to easily be deployed to sub-folders and hosts like GitHub Pages. There’s usually no special configuration required for this to work as long as the baseURL parameter has been configured in the hugo.toml file.

Docs on Blowfish

Welcome to Blowfish

Installation

Agent skill #

Getting Started

Configuration

Homepage Layout

Shortcodes

Accordion #

Front Matter

Multiple Authors

Partials

Analytics #

Thumbnails

Thumbnails #

Series

Advanced Customisation

Hosting & Deployment

Agent skill
#

Accordion
#

Analytics
#

Thumbnails
#