Skip to content

WDS BT v1.4.0 - Block Showcase & Performance Optimization

Latest
Latest

Choose a tag to compare

View all tags
@khleomix khleomix released this 16 Feb 19:12
v1.4.0
cdabb9d
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

WDS-BT 1.4.0 — Release Notes

Release date: February 17, 2026
Minimum requirements: WordPress 6.4+ (Tested up to 6.9.1), PHP 8.2+ (Tested up to 8.4), Node v25+, NPM v11+, Composer 2+

What's New

Block Showcase

Admin-only development tool to discover, preview, and inspect all registered blocks (core, theme, and third-party) with their attributes in one place. Create a page and assign the Block Showcase template to use it.

Template-Specific Style Loading

Template and custom post type CSS are built separately and enqueued only when the current request matches (404, search, archive, page templates, CPTs). Styles in build/css/templates/ are discovered automatically—no PHP config needed—reducing unused CSS and improving Lighthouse scores.

Screenshot 2026-02-06 at 5 42 20 AM

Automatic Cache Versioning

All theme-built CSS and JS use the built file’s modification time as the ver query string. Caches update after each build without manual version bumps.

Lighthouse Script

Run npm run lighthouse to audit Performance, Accessibility, Best Practices, and SEO for mobile and desktop. Scores are printed in the terminal only; URL via prompt or CLI argument.

Screenshot 2026-02-06 at 6 04 58 AM

Dominant Color Images

Automatic calculation and storage of dominant colors for uploaded images, used as background placeholders while images load for better perceived performance.

Image Prioritizer

Adds fetchpriority="high" to above-the-fold images (featured and first few in content) for improved Largest Contentful Paint (LCP).

WebP Uploads

Automatically generates WebP versions of uploaded JPEG and PNG images for better compression and faster loading. Regenerate via Tools > WDSBT Settings, WP-CLI, or helper functions.

ESLint 9

JavaScript linting upgraded to ESLint 9 with flat config format (eslint.config.cjs).

WDS-BT-Theme.5.mp4

For Developers

Strict Linting

  • PHP (PHPCS): Warnings are treated as failures (ignore_warnings_on_exit off). WPCS ^3.3.
  • JavaScript (ESLint): --max-warnings 0 in npm script and Lefthook.
  • CSS/SCSS (Stylelint): --max-warnings 0 in npm script and Lefthook.

Fixes on Commit

Lefthook runs auto-fix (PHPCBF, Prettier, Stylelint --fix, ESLint --fix), re-stages changed files, then runs strict lint. If anything still fails, the commit is blocked.

No-Verify Policy

Use of git commit --no-verify or git push --no-verify is not allowed. CI runs the same strict checks on every pull request.

Documentation

Full documentation is in the docs/ folder. The main README is a short overview with links to:

  • Development (structure, setup, NPM scripts)
  • Font Management
  • Version Management
  • Linting & Lefthook
  • Performance & Images
  • Block Showcase
  • Customizations
  • Accessibility & Quality

Upgrade Notes

  1. Pull or download the 1.4.0 release.
  2. Run npm run setup (or npm install and composer install then npm run build).
  3. If you use custom template or CPT SCSS, add files under assets/scss/templates/ as needed; they are picked up automatically.
  4. Ensure pre-commit hooks are installed (npx lefthook install runs on npm install). Do not use --no-verify when committing.

Full Changelog

For a full list of changes in this release, see the compare view (replace with your tag/branch as needed).

Assets 2
Loading