hugo-fixit/FixIt v1.0.0-alpha on GitHub

v1.0.0-alpha - 27 July 2026

Note

FixIt v1 is a ground-up rewrite of the theme's architecture, bringing modern tooling and a cleaner configuration surface to Hugo theme development.

The JavaScript layer has been fully migrated to TypeScript with a service-class architecture built on constructor injection and a typed event bus. The styling pipeline has been overhauled — CSS is now SCSS with per-layout bundles, powered by UnoCSS for utility classes and hugo:vars for runtime configuration. The build system requires Dart Sass and Hugo 0.161.0+.

Configuration has been flattened and standardized: [params.page] is now [params], and all keys follow snake_case. Content encryption has been rewritten from scratch using AES-256-GCM with PBKDF2 key derivation, extracted into the standalone fixit-encrypt tool.

Search gets a major upgrade with three engine options — Algolia, Pagefind, and a redesigned built-in fuzzy search with Bing CSE integration. Other highlights include external link guards, taxonomy icons, Mermaid pan/zoom, backdrop-filter header effects, and comprehensive accessibility improvements across all components.

This is an alpha release intended for early adopters and migration testing. See the upgrade guide for instructions.

🔀 Merged PRs

This release includes 68 merged pull requests that have been successfully integrated into the codebase.

⚠️ Breaking Changes

Assets: Rewrite content encryption with AES-256-GCM and PBKDF2 (#806) a96ba66 by @Lruihao
Params: Flatten [params.page] to [params], snake_case keys, more page-level params support (#805) 658f03d by @Lruihao
Build with Dart Sass and update Vercel deployment scripts (#746) dd6d320 by @Lruihao
Migrate theme assets from css to scss and centralize deprecation detection (#735) 09e08d0 by @Lruihao
UI/UX: Refactor styles for theme support and enhance visual consistency (#722) 164a699 by @Lruihao
Debug: Enable debug mode based on environment and remove params.dev.debug config aef8eaf by @Lruihao

🎉 New Features

Gen-docs: Add Hugo partials docs generation (#809) 2c0b483 by @Lruihao
Assets: Integrate UnoCSS for utility classes and presetIcons (#795) 8af8e80 by @Lruihao
Assets: Search UI redesign with heading, metadata and Bing CSE support (#791) a5f362f by @Lruihao
Assets: SCSS variables with hugo:vars and module setup standardization (#788) 17d7bc1 by @Lruihao
Assets: Add helpers package for chroma lexer map generation (#781) 03ca90b by @Lruihao
Assets: Improve comment system config and lang mapping (#773) 03d81f0 by @Lruihao
Search: Add pagefind search engine support (#738) 4ffd531 by @0x5c0f
Seo: Restructure head partial, fix Twitter social and SEO improvements (#749) 4e0c3d8 by @SamirPaulb
Mermaid: Performance optimization and support pan and zoom etc. (#737) e68d10d by @Lruihao
Task-lists: Add support for "Important Checked" task (#734) 9ada69e by @Lruihao
Taxonomy: Support taxonomy_icons with shared icon resolver and front matter icon overrides (#732) 1e0d1af by @Lruihao
Social: Update QQ Group link format (#731) b0a1719 by @Lruihao
Link: Add external link guard feature support (#729) 75ee162 by @0x5c0f
Accessibility: Enhance accessibility features across components and improve focus management (#725) 29ece68 by @Lruihao
Header: Refactored the blur effect to backdrop-filter and added a configuration switch (#721) 11954d8 by @Lruihao
Buttons: Replace role="button" with button elements for improved accessibility e527289 by @Lruihao
Task-list: Add task list utility mixins and enhance rendering logic 741ef19 by @Lruihao
Link: Add link_guard front matter and support for friend links 5f100a6 by @Lruihao
Post-encrypt: Add GitHub Actions workflow for publishing and versioning c6b5c82 by @Lruihao
Post-encrypt: Add help option to display usage instructions c86566f by @Lruihao
Toc: Add close button to TOC dialog and improve close functionality a4fcc5e by @Lruihao
Migrate layouts/_partials/layouts to layouts/_partials/base f76b6a1 by @Lruihao
Post-encrypt: Add elapsed time and scanned file count to output 3e4cb8d by @Lruihao
Deprecated: Project config key languageCode was deprecated in Hugo v0.158.0 and will be removed in a future release. Use locale instead. e6625fb by @Lruihao
Toc: Reorder TOC targets and add initTocDialogLink method for mobile dialog handling e58bdd4 by @Lruihao
Styles: Add new utility classes for info, primary, success, and warning backgrounds and text colors 52ab989 by @Lruihao
Code-tabs: Add dividers for inactive tabs and improve active tab styling 5fe681c by @Lruihao
Assets: Add TypeScript type declarations for Hugo @params module 54fb903 by @Lruihao
Compatible with Hugo 0.158.0+ for language methods 3242dbf by @Lruihao
.Language.LanguageName was deprecated in Hugo v0.158.0 and will be removed in a future release. Use .Language.Label instead. 391d2ec by @Lruihao
Mermaid: Add wrapper and filename named params support for shortcode 530bc6c by @Lruihao
Layouts: Add timeout and cache key options to get-remote-image partial 0d6af76 by @Lruihao
Config: Disable footer powered logos 47299db by @Lruihao

🐛 Bug Fixes

Assets: Rewrite service worker with two-strategy caching (#774) 17164f4 by @Lruihao
Tabs: Improve tab shortcode rendering and restore sticky code header (#772) 5b43c2b by @Lruihao
Seo: Restructure head partial, fix Twitter social and SEO improvements (#749) 4e0c3d8 by @SamirPaulb
Change social.yml (twitter.com -> x.com, change github icon) (#748) 55b8095 by @myServiceAccount
Dart Sass compatibility + feat: add imagePreview config for home page (#741) e68bdb3 by @myServiceAccount
Assets: Rewrite service worker with two-strategy caching (#774) 17164f4 by @Lruihao
Assets: Restructure SCSS pages directory and fix positioning issues 20c0997 by @Lruihao
Header: Update header styles and improve layout structure 295717a by @Lruihao
Layouts: Fix toggle code block YAML conversion for identical values 3326ea4 by @Lruihao
Tabs: Revert tab and tabs rendering (#772) and update chroma lexers a2d7567 by @Lruihao
Header: Improve header animation on scroll events e0a0086 by @Lruihao
Layouts: Fix Content+Path code path in style/script plugin partials d076ebf by @Lruihao
Assets: Apply correct json-viewer theme after content decryption 610fa1d by @Lruihao
Code: Fix line number styling for better visibility 78778da by @Lruihao
Assets,layouts: Correct page_style comment and remove newlines from deprecation warnings 5811b21 by @Lruihao
Assets: Fix sw-update-notification display and PWA guard conditions 4050249 by @Lruihao
Assets: Fix nil pointer in icon.html and correct QQ icon names b5419ef by @Lruihao
Versioning: Improve staged files handling in updateVersion function 8efdce7 by @Lruihao
Versioning: Improve version regex and add error handling for version extraction e68200a by @Lruihao
Toc: Update max-height calculation for TOC content to use variable 66dc7bc by @Lruihao
Assets: Prevent mermaid render temp div from expanding body height 1012fdc by @Lruihao
Assets: Handle SKIP_WAITING message in service worker 9da44f0 by @Lruihao
Workflow: Properly propagate parallel build errors on Vercel db85dcb by @Lruihao
Layouts: Fix busuanzi site views variable name in footer e07eefd by @Lruihao
Styles: Content style priority conflict 7a28234 by @Lruihao
Assets: Move reward shortcode styles to shared shortcodes d81d1a0 by @Lruihao
Assets: Use percentage unit for color.mix weight in tag cloud eeff00f by @Lruihao
Layout: Specify selector for comments section in SCSS 9566450 by @Lruihao
Versioning: Enable console log for Node.js version check in updateVersion function a2d4b46 by @Lruihao

⚡ Performance Improvements

Home: Disable third-party resource loading on the home page, and improve plugin comments 502e427 by @Lruihao
Code-tab: Enhance code toggle functionality with improved tab switching and state management f9c7e1d by @Lruihao
Mermaid: Optimize pan/zoom transform handling and improve theme synchronization cedff86 by @Lruihao
Mermaid: Improve error handling and optimize rendering for mobile 5e6e290 by @Lruihao

♻️ Refactoring and Updates

Assets: PWA improvements and app config snake_case migration (#790) 5cad4d3 by @Lruihao
Assets: Split SCSS into per-layout CSS bundles (#789) 47247e0 by @Lruihao
Assets: SCSS variables with hugo:vars and module setup standardization (#788) 17d7bc1 by @Lruihao
Search: Refactor search module and upgrade autocomplete library (#787) a696f3b by @Lruihao
Assets: Migrate JavaScript to TypeScript service architecture (#766) 14a965f by @Lruihao
Mermaid: Performance optimization and support pan and zoom etc. (#737) e68d10d by @Lruihao
Layout: Refactor single page layout and partials categorization cfa9bef by @Lruihao
Css: Rename functions from 'fixit-' to 'fi-' for consistency b406a56 by @Lruihao
Restructure TypeScript modules and search config 6f83bc6 by @Lruihao
Assets: Streamline decrypt and toc event flow 43c439e by @Lruihao
Encrypt: Rename post-encrypt to encrypt bfee404 by @Lruihao
Assets: Improve custom script examples and SCSS configuration 4b3f33f by @Lruihao
Assets: Use ES6 # private fields instead of TS private a5d24f3 by @Lruihao
Assets: Simplify template pipeline and resource handling 76f8097 by @Lruihao
Assets: Simplify breakpoints and update UnoCSS CLI config fb0c00e by @Lruihao
Extract console banner to core/banner.ts 01eadc4 by @Lruihao
Styles: Replace mixin user-select with direct property assignment 3dd16e6 by @Lruihao
Layouts: Simplify alternative output format link rendering e30b9db by @Lruihao
Replace media queries with mixin for responsive design consistency b172fd4 by @Lruihao

📝 Documentation Changes

Correct German and Japanese language links in README files (#736) 77bb00c by @aetos382
Config: Standardize hugo.toml comments for gendocs compatibility 6188165 by @Lruihao
Layouts: Add header comments to undocumented partials 5322a15 by @Lruihao
Update theme documentation links 874337f by @Lruihao
Improve clarity and formatting in README files a4a0eb1 by @Lruihao
Update contributing guidelines 0fe8e10 by @Lruihao
Update v1 migration guide and fixit-encrypt repository a5a7b98 by @Lruihao
Update contributing guide and pull request template 799618f by @Lruihao
Encrypt: Update Go implementation status to Available 15b415f by @Lruihao
Readme: Update acknowledgements 279021d by @Lruihao
Update README to clarify versioning policy and future plans 7338930 by @Lruihao
Config: Improve search and compatibility section comments in hugo.toml b95a29e by @Lruihao
Config: Fix typo 69920e0 by @Lruihao

✅ Changes to Test Assets

Post-encrypt: Add performance benchmark script 78f1a85 by @Lruihao

🎨 Tidying of Code eg Whitespace

Hugo.toml: Standardize comment capitalization for consistency 9e40051 by @Lruihao
Mixins: Format SCSS mixins for better readability 4158ebf by @Lruihao
Assets: Rebuild unocss.css f5509e5 by @Lruihao
Search: Add transition to close button hover effect 68d9a35 by @Lruihao
Correct comment f911547 by @Lruihao
Assets: Use cooler and darker hover colors for menu items in dark mode 9e2f388 by @Lruihao

🔧 Chores And Housekeeping

Deps: Bump @algolia/autocomplete-js from 1.19.8 to 1.19.9 (#804) bfef6c5 by @github-actions[bot]
Deps: Bump algoliasearch from 5.53.0 to 5.55.1 (#803) 069ddd1 by @github-actions[bot]
Deps: Bump @fortawesome/fontawesome-free from 7.2.0 to 7.3.0 (#802) daa0753 by @github-actions[bot]
Deps: Bump simple-icons from 16.23.0 to 16.24.1 (#800) 743ecd2 by @github-actions[bot]
Deps: Bump mapbox-gl from 3.24.0 to 3.25.0 (#801) 76530ce by @github-actions[bot]
Deps: Bump twikoo from 1.7.11 to 1.7.13 (#799) 5ee8272 by @github-actions[bot]
Deps-dev: Bump the npm-development group with 9 updates (#798) 994a5d4 by @dependabot
Deps: Bump actions/checkout from 6 to 7 (#797) 575499d by @dependabot
Deps: Bump actions/setup-node from 4 to 6 (#784) 3c2fb3e by @dependabot
Deps: Bump simple-icons from 16.22.0 to 16.23.0 (#783) 47ebabd by @lrhx
Deps: Bump @waline/client from 3.15.0 to 3.15.2 (#782) 43dd1c7 by @lrhx
Deps: Bump simple-icons from 16.21.0 to 16.22.0 (#780) 5362040 by @github-actions[bot]
Deps: Bump @waline/client from 3.13.0 to 3.15.0 (#779) f7ec3e3 by @github-actions[bot]
Deps: Bump twikoo from 1.7.10 to 1.7.11 (#777) 5862699 by @github-actions[bot]
Deps: Bump algoliasearch from 5.52.1 to 5.53.0 (#776) 031691a by @github-actions[bot]
Deps-dev: Bump the npm-development group across 1 directory with 6 updates (#775) b8ec5f1 by @dependabot
Deps: Bump twikoo from 1.7.9 to 1.7.10 (#771) 038f602 by @github-actions[bot]
Deps: Bump echarts from 6.0.0 to 6.1.0 (#770) 7cab906 by @github-actions[bot]
Deps: Bump simple-icons from 16.19.0 to 16.21.0 (#769) 0c30f4c by @github-actions[bot]
Deps: Bump katex from 0.16.47 to 0.17.0 (#768) f78e5b9 by @github-actions[bot]
Deps: Bump mapbox-gl from 3.23.1 to 3.24.0 (#767) aa3b591 by @github-actions[bot]
Deps: Bump simple-icons from 9.19.0 to 16.19.0 (#765) a9b380c by @github-actions[bot]
Deps: Bump @fortawesome/fontawesome-free from 7.1.0 to 7.2.0 (#764) f764563 by @github-actions[bot]
Deps: Bump sharer.js from 0.5.1 to 0.5.4 (#763) a7503c4 by @github-actions[bot]
Deps: Bump gitalk from 1.7.2 to 1.8.0 (#762) 76de476 by @github-actions[bot]
Deps: Bump typeit from 8.8.4 to 8.8.7 (#761) 91d483a by @github-actions[bot]
Deps: Bump xxhash-wasm from 1.0.2 to 1.1.0 (#760) cd7b1e7 by @github-actions[bot]
Deps: Bump mapbox-gl from 2.10.0 to 3.23.1 (#759) 819051e by @github-actions[bot]
Deps: Bump pangu from 4.0.7 to 7.2.1 (#758) ed8ec5c by @github-actions[bot]
Deps: Bump meting from 2.0.1 to 2.0.2 (#757) caf2b08 by @github-actions[bot]
Deps: Bump algoliasearch from 4.20.0 to 5.52.1 (#756) a82d8c3 by @github-actions[bot]
Deps: Bump echarts from 5.3.3 to 6.0.0 (#755) d59bb2d by @github-actions[bot]
Deps: Bump twikoo from 1.7.3 to 1.7.9 (#754) ebf1e7e by @github-actions[bot]
Deps: Bump @waline/client from 3.12.1 to 3.13.0 (#753) ee299ce by @github-actions[bot]
Deps: Bump lightgallery from 2.7.2 to 2.9.0 (#752) f544826 by @github-actions[bot]
Deps: Bump valine from 1.5.2 to 1.5.3 (#750) 57206e5 by @github-actions[bot]
Deps: Bump katex from 0.16.22 to 0.16.47 (#751) 16e9660 by @github-actions[bot]
Deps: Bump pnpm/action-setup from 4 to 6 (#740) 26b0556 by @dependabot
Deps: Bump softprops/action-gh-release from 2 to 3 (#739) e90a249 by @dependabot
Deps: Upgrade fuse.js from v6.6.2 to v7.4.2 c057a0d by @Lruihao
Deps: Update Node.js, pnpm, and dev dependencies e458019 by @Lruihao
Deps-dev: Update pnpm and dev dependencies 97ddee0 by @Lruihao
Add librarybot workflow for automated npm library updates (#726) d45f6b1 by @Lruihao
Packages: Replace helpers with standalone chroma-lexers and enrich shared f5b030b by @Lruihao
Deps: Upgrade algoliasearch from v4 to v5 lite client 9ed063f by @Lruihao
Update minimum Hugo version to 0.158.0 across documentation and configuration files 673be1e by @Lruihao
Deps: Update concurrently to version 10.0.3 0f35108 by @Lruihao
Add Dockerfile and devcontainer configuration for Hugo theme development bc3fb3a by @Lruihao
Workflow: Support nextVersion for dev version base a7cf343 by @Lruihao
Update theme configuration e4bd573 by @Lruihao
Deps: Update pangu.js references and configuration ebcf22d by @Lruihao
Vscode: Update file nesting patterns in VSCode settings ba369ae by @Lruihao
Updated pnpm configuration and optimized versioning scripts 4cba468 by @Lruihao
Update VSCode extensions and improve asset loading in templates 20f59e0 by @Lruihao
Assets: Add librarybot dir entries for katex/lightgallery/fontawesome static assets ea140e3 by @Lruihao
Bump minimum Hugo version to 0.161.0 for hugo:vars support b7db52e by @Lruihao
Vscode: Update extensions and settings for improved SCSS and template support ddbf47d by @Lruihao
Pnpm v11 migration 4a60d80 by @Lruihao
Clean up VSCode settings d35dd6a by @Lruihao
Deps: Remove gitsubmodule package ecosystem from dependabot configuration 6070061 by @Lruihao
Init: Update warning messages for deprecated parameters 557a59d by @Lruihao
Assets: Move tsconfig to assets a7bae57 by @Lruihao
Config: Remove deprecated hugoVersion.extended b274b1b by @Lruihao
Workflows: Add token for bot authentication in gen-lexers and librarybot workflows c7ed62c by @Lruihao

👷 Continuous Integration

Ignore mermaid.js in codeql and eslint 12187b0 by @Lruihao

Full Changelog: v0.4.5...v1.0.0-alpha

New Contributors

@aetos382 made their first contribution in #736
@myServiceAccount made their first contribution in #741
@lrhx made their first contribution in #782