v3.10.02026-11-11
Highlights
- ✨ llms.txt now includes an optional one-line site summary after the title, taken from the homepage description or the site description as a fallback. Output is unchanged when neither is set. (by @PierreMesure in #3156, fixes #3153)
- 🔒 Optional Subresource Integrity for the Umami Analytics script. Set umamiAnalytics.integrity and the theme adds integrity and crossorigin="anonymous" to the tracker tag for both Umami Cloud and custom domains. (by @nourkagha in #3135)
- ✨ New Credly social icon and author link. (by @wollmannbruno in #3130)
- 🩹 Ko-fi follow-ups: the widget label now has a localized default in every supported language with kofi.globalWidgetText as an override, and both the widget and the scroll-to-top offset are guarded on kofi.identifier being set. (by @nourkagha in #3126)
Fixes
- 🐛 Social sharing links now percent-encode the article title and URL separately, so titles containing & or other reserved characters no longer truncate the share text on Bluesky and Mastodon. (by @aplgr in #3141, fixes #3140)
- 🐛 llms.txt honors externalUrl for external articles, matching the article listings, and falls back to the permalink when it is absent. (by @PierreMesure in #3150, fixes #3149)
- 🐛 Code blocks and tables inside the alert shortcode now scroll within the alert instead of overflowing it and widening the page on phones. (by @khadirullah in #3131)
- 🐛 The gallery shortcode uses two decimal places for grid widths, so thirds no longer leave a visible gap. (by @felibri in #3128)
- 📝 The forgejo shortcode example and forgejoDefaultServer now point at codeberg.org. The previous test instance serves an invalid certificate and produced build warnings in every language of the example site. (by @nunocoracao)
Maintenance
- Supported Hugo range is now 0.166.0 - 0.169.0. (by @github-actions in #3129)
- Bump Mermaid from 12.1.0 to 12.3.0. (by @dependabot in #3137 and #3161)
- Bump medium-zoom from 1.1.0 to 1.1.2, which honors reduced-motion preferences and allows closing a zoom while the image is still loading. (by @dependabot in #3157)
- Bump KaTeX from 0.19.0 to 0.19.1. (by @dependabot in #3144)
- Bump Chart.js from 4.5.1 to 4.6.1. (by @dependabot in #3145)
- Bump Tailwind CSS and @tailwindcss/cli from 4.3.3 to 4.3.5. (by @dependabot in #3162 and #3163)
- Bump Puppeteer from 25.12.0 to 25.16.0, Prettier from 3.9.9 to 3.9.10, commander from 15.0.0 to 15.1.0, rimraf from 6.1.3 to 6.1.4, and fast-xml-parser from 5.11.2 to 5.12.0 in dev and script dependencies. (by @dependabot in #3143, #3132, #3159, #3160 and #3165)
- Showcase pages generated for the three sites added in v3.9.0, and the user screenshot script no longer aborts when a site's third-party script stalls the page load. (by @nunocoracao)
New Contributors
- @khadirullah made their first contribution in #3131
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.9.0...v3.10.0
v3.9.02026-10-07
Highlights
- ✨ New Ko-fi global widget, alongside the existing Buy Me a Coffee integration. Enable it with the new [kofi] params (identifier, globalWidget, globalWidgetText, globalWidgetBackgroundColor, globalWidgetTextColor). The widget is hidden in zen mode and print, and the scroll-to-top button moves out of its way in RTL layouts. (by @nourkagha in #3118)
Fixes
- 🐛 layoutBackgroundBlurStyle = "classic" now restores the pre-v3 gradient overlays on the hero background, so text over the image is readable again. (by @0r1k in #3107 for #3106)
- 🐛 The language redirect partial now uses .Language.Locale, removing the Hugo deprecation warning on multilingual sites with language redirect enabled. (by @PierreMesure in #3109, fixes #3108)
Maintenance
- Supported Hugo range is now 0.164.0 - 0.167.0. (by @github-actions in #3113)
- Bump Mermaid from 11.17.2 to 12.1.0 (major version - please report any diagram rendering changes). (by @dependabot in #3123)
- Bump KaTeX from 0.18.7 to 0.19.0. (by @dependabot in #3122)
- Bump Puppeteer from 25.11.0 to 25.12.0. (by @dependabot in #3117)
- Bump Prettier from 3.9.8 to 3.9.9. (by @dependabot in #3116)
- 🔒 Fix all open Dependabot security alerts in dev and script dependencies (no change to shipped assets). (by @nunocoracao in #3124)
- Add new sites to the Blowfish users showcase. (by @stilicho2011 in #3111, @nourkagha in #3119 and @gwils28 in #3120)
New Contributors
- @stilicho2011 made their first contribution in #3111
- @PierreMesure made their first contribution in #3109
- @nourkagha made their first contribution in #3119
- @gwils28 made their first contribution in #3120
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.8.0...v3.9.0
v3.8.02026-09-24
Highlights
- ✨ New layoutBackgroundBlurStyle option for the background hero style: fade (default, v3 behaviour) or classic to restore the pre-v3 persistent blurred backdrop. Available for article, list, taxonomy and term pages. (#3101, closes #3089)
- ♟️ New Chess.com and Lichess social icons. (#3100)
Maintenance
- Bump Mermaid from 11.17.2 to 12.0.0 (major version — please report any diagram rendering changes). (#3098)
- Bump KaTeX from 0.18.6 to 0.18.7. (#3097)
- Bump Puppeteer from 25.10.0 to 25.11.0. (#3102)
- Bump Prettier from 3.9.6 to 3.9.8. (#3103)
- Add new sites to the Blowfish users showcase. (#3096, #3099, #3104)
New Contributors
- @wiebe-vandendriessche made their first contribution in #3096
- @meroxdotdev made their first contribution in #3104
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.7.0...v3.8.0
v3.7.02026-09-13
Highlights
This release improves performance and fixes several development and navigation issues:
- ⚡ Fixes a major v3 scrolling performance regression in card components by removing expensive backdrop blur effects. Similar effects in the stats and feature shortcodes are not yet addressed. (#3091)
- 🐛 Fixes smart TOC highlighting on short pages that cannot scroll. (#3088)
- 🛠️ Restores referenced guides in the development configuration by correcting ignoreFiles. (#3090)
- ⚙️ Updates the supported Hugo version. (#3094)
Maintenance
- Bump KaTeX from 0.18.4 to 0.18.6. (#3092)
- Bump Puppeteer from 25.9.0 to 25.10.0. (#3093)
- Add new sites to the Blowfish users showcase. (#3076, #3083, #3085)
New Contributors
- @alrayyes made their first contribution in #3088
- @byalpay-lab made their first contribution in #3076
- @wollmannbruno made their first contribution in #3083
- @siyalight made their first contribution in #3085
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.6.0...v3.7.0
v3.6.02026-09-03
What's Changed
* ✨ Add a clearer discovery path for Blowfish by @friday-oc in https://github.com/nunocoracao/blowfish/pull/3075
* 📌 bump mermaid from 11.17.0 to 11.17.2 by @dependabot[bot] in https://github.com/nunocoracao/blowfish/pull/3080
* 📌 bump puppeteer from 25.8.0 to 25.9.0 by @dependabot[bot] in https://github.com/nunocoracao/blowfish/pull/3081
* ➕ Add yannick.services to users list by @ytocquet in https://github.com/nunocoracao/blowfish/pull/3078
* feat: add llms.txt discovery link by @friday-oc in https://github.com/nunocoracao/blowfish/pull/3082
* 🐛 Guard event.key before toLowerCase in search keydown handler by @ytocquet in https://github.com/nunocoracao/blowfish/pull/3077
New Contributors
* @ytocquet made their first contribution in https://github.com/nunocoracao/blowfish/pull/3078
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.5.0...v3.6.0
v3.5.02026-08-29
What's Changed
* fix: mobile menu wrong height by @ZhenShuo2021 in https://github.com/nunocoracao/blowfish/pull/3073
* 📌 bump puppeteer from 25.7.0 to 25.8.0 by @dependabot[bot] in https://github.com/nunocoracao/blowfish/pull/3071
* 📌 bump mermaid from 11.16.1 to 11.17.0 by @dependabot[bot] in https://github.com/nunocoracao/blowfish/pull/3070
* 🐛 Render HTML in series widget titles by @tekenstam in https://github.com/nunocoracao/blowfish/pull/3072
New Contributors
* @tekenstam made their first contribution in https://github.com/nunocoracao/blowfish/pull/3072
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.4.0...v3.5.0
v3.4.02026-08-22
What's Changed
* fix: katex not rendering by @ZhenShuo2021 in https://github.com/nunocoracao/blowfish/pull/3063
* fix: medium-zoom conflict with featureImageHover by @ZhenShuo2021 in https://github.com/nunocoracao/blowfish/pull/3065
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.3.0...v3.4.0
v3.3.02026-08-21
Quick patch release restoring two scripts broken by the v3 performance work. 🐡
🐛 Fixes
- Image zoom works again — the v3 defer on the zoom library made the inline init run before the library loaded; the init now ships as a deferred script ordered after the library — thanks @ZhenShuo2021! (#3060, #3061)
- Buy Me a Coffee widget renders again — the widget script relies on DOMContentLoaded and never initialized when lazy-loaded after page idle; it's back to a regular script tag — thanks @ZhenShuo2021! (#3061)
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.2.0...v3.3.0
v3.2.02026-08-19
Menu polish and dependency updates. 🐡
🐛 Fixes
- Mobile dropdown menu now closes when clicking outside it — thanks @Metalhearf! (#3059)
- Desktop dropdown panels have balanced padding — a leftover top-padding override made the first item sit too close to the edge — thanks @Metalhearf! (#3058)
- Fullscreen mobile menu renders at full height again — the floating header's backdrop blur was trapping it at the header's size (#3057)
- Repaired dependency version metadata in the lockfile
📦 Dependencies
- KaTeX bumped to 0.18.4, including the vendored assets (#3056)
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.1.0...v3.2.0
v3.1.02026-08-18
The 404 page's movie quotes now speak your language. 🎬
✨ What's new
- Localized 404 quotes — all nine bundled movie quotes are now available in 36 languages, selected automatically for each page's locale at build time (exact locale → base language → English fallback). Famous lines use their canonical dubs where they exist ("Ihr könnt nicht vorbei!"). Custom data/quotes404.json overrides keep working — entries without a lang field are treated as English, and per-language quote sets are now documented in the configuration docs.
Implements the design proposed by @ohmykreee in discussion #3051 — thank you!
🧰 Housekeeping
- Removed the defunct merch link and stargazer chart from the READMEs
Full Changelog: https://github.com/nunocoracao/blowfish/compare/v3.0.0...v3.1.0