Skip to content

v1.0.0-alpha

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 27 Jul 07:08
v1.0.0-alpha
This tag was signed with the committer’s verified signature.
Lruihao Cell
SSH Key Fingerprint: VmFD/lHizhVMYUgXKVp7CLlw3lLPJZHB+ix3oGD3YMc
Verified
Learn about vigilant mode.
a73416e
This commit was signed with the committer’s verified signature.
Lruihao Cell
SSH Key Fingerprint: VmFD/lHizhVMYUgXKVp7CLlw3lLPJZHB+ix3oGD3YMc
Verified
Learn about vigilant mode.

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

📝 Documentation Changes

✅ Changes to Test Assets

🎨 Tidying of Code eg Whitespace

🔧 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

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

New Contributors

Contributors

aetos382, 0x5c0f, and 5 other contributors
Assets 4
Loading