v3.0.0

[nunocoracao]

Blowfish v3 is here — the biggest release in the theme's history: a full UI/UX revamp with a new visual identity, new layouts, new shortcodes, and first-class support for AI coding agents.

Important

Coming from v2? The upgrade is fully backwards compatible — every new feature is opt-in, nothing was removed or renamed, and your site will look the same until you enable the new options. Follow the migration guide: git-submodule and manual installs update as usual; Hugo-module users change one import line to github.com/nunocoracao/blowfish/v3.

✨ Visual system

• 🪟 Floating glass header (header.layout = "floating") — translucent blur pill with a slim profile and a ⌘K / Ctrl+K search shortcut
• 🛬 Landing homepage layout (homepage.layout = "landing") — editorial hero with eyebrow, headline, lead, CTA buttons (including a build-time GitHub star-count button), and an optional full-width hero image
• 🌌 Background canvas (backgroundCanvas) — a site-wide backdrop that hero images dissolve into; article heroes fade out on scroll to reveal it
• 🎨 New burufugu colour scheme — the mascot's own palette, WCAG AA-checked
• 🃏 Refreshed cards with glass surfaces, centered crops, and an optional hover zoom (list.featureImageHover)
• 🏷️ Taxonomy pages redesigned with compact pill tags
• 🎬 A movie-quote 404 page and an interactive homepage layout switcher (homepage.layoutSwitcher)
• 📱 New dropdown mobile menu style (header.mobileMenuStyle = "dropdown") with the language selector in the header row

🧩 New shortcodes

stats/stat · feature-grid/feature · steps/step · cta — plus automatic grid balancing so odd card counts fill their rows cleanly.

🤖 Built for AI agents

Blowfish now ships an agent skill that teaches coding agents (like Claude Code) how to install, configure, and build with the theme — including the theme's architecture, so agents navigate your site's code effectively:

/plugin marketplace add nunocoracao/blowfish
/plugin install blowfish@blowfish

♿ Accessibility & 🖨️ Print

• Keyboard-operable mobile menu, search dialog with focus trap, ARIA tabs, labelled landmarks, reduced-motion guards, AA contrast fixes
• Dedicated print styles: @page margins, chrome hidden, dark mode prints light, external link URLs printed

⚡ Performance

• Firebase and BuyMeACoffee load after idle instead of competing with rendering
• Deferred scripts, lazy imagery, optimized screenshots

🐛 Fixes

Resolves #2938, #2974, #2996, #3003, #3013, #3016, #3017, #3023, #3037, #3040 — including the i18n-apostrophe JavaScript bug, the schema author image, avatar crop consistency, and comments in the simple layout.

🧰 Housekeeping

• Docs revamped and synced across all 9 languages, with a new upgrade guide
• Hugo module path is now /v3; supported Hugo versions follow a rolling latest-4 window (currently 0.162.0–0.165.0), kept current automatically
• New screenshots, refreshed READMEs in every language, and a friendlier stale-issue policy (14-day grace window)

What's Changed

• 🚀 Blowfish v3 UI/UX revamp by @nunocoracao and @friday-oc in 🚀 Blowfish v3 UI/UX revamp #3028

Full Changelog: v2.106.0...v3.0.0

---

This discussion was created from the release v3.0.0.