# nunocoracao/blowfish

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/nunocoracao-blowfish).**

2,622 stars · 683 forks · HTML · mit

## Links

- GitHub: https://github.com/nunocoracao/blowfish
- Homepage: https://blowfish.page
- awesome-repositories: https://awesome-repositories.com/repository/nunocoracao-blowfish.md

## Topics

`blog` `blog-theme` `blowfish` `feature-rich` `hugo` `hugo-blog-theme` `hugo-theme` `mit-license` `responsive` `theme` `well-documented`

## Description

Blowfish is a responsive theme for the Hugo static site generator, designed for creating content-focused websites. It utilizes the Tailwind CSS UI framework for utility-first styling and a Go-based engine to transform templates into plain HTML.

The project features a technical content renderer that transforms LaTeX and Mermaid syntax into mathematical equations and SVG diagrams. It includes a serverless search system that generates a JSON index at build time for client-side retrieval and a multilingual publishing framework with support for right-to-left scripts.

The theme covers a broad range of capabilities, including real-time data integration via Firebase, automated image optimization, and various content organization tools such as series grouping and related post discovery. It also provides layout options like distraction-free reading mode and a library of rich UI elements such as standardized alert boxes.

A command-line tool is provided to automate project bootstrapping, theme installation, and initial configuration.

## Tags

### Content Management & Publishing

- [Static Site Themes](https://awesome-repositories.com/f/content-management-publishing/blog-post-rendering/static-site-themes.md) — A responsive Hugo theme utilizing Tailwind CSS to create content-focused static websites.
- [Static Site Generators](https://awesome-repositories.com/f/content-management-publishing/static-site-generators.md) — A high-performance Hugo theme that compiles templates and markdown into optimized static HTML files.
- [Technical Content Renderers](https://awesome-repositories.com/f/content-management-publishing/content-processing-transformation/markdown-markup-tools/markdown-tools/technical-content-renderers.md) — Transforms technical content, including LaTeX for math and Mermaid for diagrams, into rendered web formats.
- [Client-Side Search Indices](https://awesome-repositories.com/f/content-management-publishing/static-site-generators/client-side-search-indices.md) — Implements a serverless search system using a build-time JSON index queried client-side via Fuse.js.
- [Featured Image Management](https://awesome-repositories.com/f/content-management-publishing/article-organization-tools/featured-image-management.md) — Enables the configuration of featured thumbnails and hero images for articles to improve visual appeal. ([source](https://blowfish.page/docs/getting-started/))
- [CMS Layout Management](https://awesome-repositories.com/f/content-management-publishing/cms-layout-management.md) — Offers multiple distinct layout options for the main landing page of the site. ([source](https://github.com/nunocoracao/blowfish/blob/main/README.ja.md))
- [Content Discovery & Organization](https://awesome-repositories.com/f/content-management-publishing/content-discovery-organization.md) — Displays a list of related articles sharing common tags or categories to increase engagement. ([source](https://cdn.jsdelivr.net/gh/nunocoracao/blowfish@main/README.md))
- [Mathematical Notation Renderers](https://awesome-repositories.com/f/content-management-publishing/markdown-renderers/mathematical-notation-renderers.md) — Transforms LaTeX markup into formatted mathematical equations during the build process.
- [Multilingual Publishing](https://awesome-repositories.com/f/content-management-publishing/multilingual-publishing.md) — Provides a comprehensive framework for publishing and managing content across multiple languages, including right-to-left script support.
- [RSS Feed Generation](https://awesome-repositories.com/f/content-management-publishing/rss-feed-generation.md) — Automatically generates machine-readable RSS feeds of recent articles for content syndication. ([source](https://cdn.jsdelivr.net/gh/nunocoracao/blowfish@main/README.md))
- [Search Visibility Optimizations](https://awesome-repositories.com/f/content-management-publishing/search-visibility-optimizations.md) — Implements SEO best practices and social sharing metadata to improve search engine discoverability. ([source](https://github.com/nunocoracao/blowfish/blob/main/README.zh-cn.md))

### Web Development

- [Static Site Generators](https://awesome-repositories.com/f/web-development/static-site-generators.md) — Uses a Go-based engine to transform templates and content into static HTML files.
- [Shortcodes](https://awesome-repositories.com/f/web-development/content-insertion-utilities/dynamic-content-insertion/shortcodes.md) — Processes custom shortcode tags during build to inject interactive components like galleries and diagrams.
- [Utility-First CSS Frameworks](https://awesome-repositories.com/f/web-development/utility-first-css-frameworks.md) — Utilizes a utility-first CSS framework to define responsive layouts and styles via atomic classes.
- [Series Grouping](https://awesome-repositories.com/f/web-development/api-management-tools/content-static-site-generation/content-collection-managers/collection-manipulation-utilities/collection-partitioning-grouping/series-grouping.md) — Groups related articles into a sequence to facilitate sequential navigation through a series. ([source](https://cdn.jsdelivr.net/gh/nunocoracao/blowfish@main/README.md))
- [Firebase Real-time Data Integrations](https://awesome-repositories.com/f/web-development/firebase-real-time-data-integrations.md) — Implements a system that pulls real-time data from Firebase via JavaScript to update content without rebuilding.
- [Image Optimization Tools](https://awesome-repositories.com/f/web-development/image-optimization-tools.md) — Automatically scales and optimizes images during the build process to improve page load speeds. ([source](https://github.com/nunocoracao/blowfish/blob/main/README.ja.md))
- [Multi-Language Content Delivery](https://awesome-repositories.com/f/web-development/internationalization-localization/translation-management-platforms/site-localization/multi-language-content-delivery.md) — Serves translated page versions with support for right-to-left scripts and automated routing.
- [Real-Time Data Integrations](https://awesome-repositories.com/f/web-development/real-time-data-integrations.md) — Integrates Firebase via client-side JavaScript to stream real-time data into page content without requiring site rebuilds.

### Development Tools & Productivity

- [Build-Time Asset Processing](https://awesome-repositories.com/f/development-tools-productivity/build-time-asset-processing.md) — Processes images, LaTeX, and Mermaid syntax into optimized production assets during the build phase.
- [Mermaid Diagram Renderers](https://awesome-repositories.com/f/development-tools-productivity/markdown-documentation-systems/diagram-integrations/mermaid-diagram-renderers.md) — Renders diagrams defined with Mermaid syntax into SVG graphics during site compilation.
- [Navigation Systems](https://awesome-repositories.com/f/development-tools-productivity/navigation-systems.md) — Implements a hierarchical navigation system with multi-level dropdown menus in the header and footer. ([source](https://cdn.jsdelivr.net/gh/nunocoracao/blowfish@main/README.md))
- [Search Indexers](https://awesome-repositories.com/f/development-tools-productivity/search-indexers.md) — Generates a JSON search index at build time to enable fast client-side keyword retrieval.

### Software Engineering & Architecture

- [Multilingual Site Support](https://awesome-repositories.com/f/software-engineering-architecture/infrastructure-configuration-languages/multi-language-support/multilingual-site-support.md) — Provides a comprehensive framework for serving site content in multiple languages with automated routing and right-to-left support. ([source](https://cdn.jsdelivr.net/gh/nunocoracao/blowfish@main/README.md))

### User Interface & Experience

- [Color Scheme Managers](https://awesome-repositories.com/f/user-interface-experience/color-scheme-managers.md) — Allows users to apply predefined color palettes or custom themes to change the site's appearance. ([source](https://github.com/nunocoracao/blowfish/blob/main/README.ja.md))
- [Content Cards](https://awesome-repositories.com/f/user-interface-experience/data-display-components/content-cards.md) — Renders posts and pages using configurable card views to organize content visually. ([source](https://blowfish.page/))
- [Distraction-Free Reading Modes](https://awesome-repositories.com/f/user-interface-experience/distraction-free-reading-modes.md) — Provides a layout option that hides navigation and UI elements for a minimalist reading experience. ([source](https://github.com/nunocoracao/blowfish/blob/main/README.ja.md))
- [Dark Mode Strategies](https://awesome-repositories.com/f/user-interface-experience/presentation-frameworks/theme-systems/dark-mode-strategies.md) — Ships with a mechanism to toggle between light and dark color schemes automatically or manually. ([source](https://cdn.jsdelivr.net/gh/nunocoracao/blowfish@main/README.md))
- [Table of Contents Components](https://awesome-repositories.com/f/user-interface-experience/table-of-contents-components.md) — Provides a scrollable, independent table of contents for articles that tracks the reader's position through anchor highlighting. ([source](https://cdn.jsdelivr.net/gh/nunocoracao/blowfish@main/README.md))
- [Visual Style Customization](https://awesome-repositories.com/f/user-interface-experience/visual-style-customization.md) — Provides a system for overriding default designs by defining custom colors and utility classes. ([source](https://cdn.jsdelivr.net/gh/nunocoracao/blowfish@main/README.md))