Features
- Registered
sq-bg-primary,sq-bg-secondary, andsq-bg-accentas a Tailwind CSS plugin. This enables full support for all Tailwind variant modifiers (hover:,dark:,group-[*], etc.) while maintaining auto-contrast functionality via CSS variables.
Refactors
- Simplified
_utilities.scssby shifting background and color logic to the Tailwind configuration, enabling a more standard Tailwind experience. - Introduced the
sq-highlightgradient text utility for cross-theme headline accents. - Optimized
_base.scsstypography and selection styling to be more robust and theme-consistent.
Docs
- Added Custom Utilities as a reference guide for built-in custom SCSS classes.
Affected Files
tailwind.config.jssrc/assets/scss/_utilities.scsssrc/assets/scss/_base.scss
Features
- Implement a fully modular deployment utility (
scripts/utils/deploy.js) to support automated preview deployments to Vercel and Netlify during the packaging phase. - Use
squeditor.config.jsto add custom deployment providers. Each provider requires a name, a CLI command, and optional setup tips Learn more. - Integrate the deployment script into
package-dist.jsand updatesqueditor.config.jswith newdeployconfiguration options (deploy.enabledanddeploy.platform).
Fixes
- Enhance the theme switcher (
theme-switcher.php) class toggling logic to accurately sync the.sq-theme-darkclass on the root<html>element as well as the<body>element, ensuring Tailwind CSS dark mode selectors operate consistently across the interface. - Update
base.phpFOUC script to reliably apply and persist dynamic schema styling upon page initialization without being incorrectly overridden by hardcoded PHP classes.
Affected Files
package.jsonsqueditor.config.jssrc/page-templates/base.phpsrc/template-parts/theme-switcher.phpscripts/package-dist.js
New Files
scripts/utils/deploy.js
Features
- Customer package builder (
package-customer.js) is now fully generic —tailwind.config.js,postcss.config.js,.prettierrc, dependencies, and SCSS globals are all derived from the project’s own files instead of being hardcoded in the framework. - Pre-compiled CSS and static assets are discovered dynamically from
dist/— any file a developer adds flows through automatically without touching the framework. - Added
customerDevDepsoption insqueditor.config.jsto extend the customer devDependencies without editing framework scripts. uikit-components.jsmoved topublic/so Vite never attempts to bundle it.- Customer
dist/is pre-populated with compiled JS so it works immediately without requiringnpm run build. - FOUC prevention injected into customer
src/HTML for clean dev-mode experience.
Fixes
- Eliminated all Vite build warnings —
uikit-components.jsbundling warning, font@font-faceresolution warnings, and static asset URL warnings. - Fixed theme switcher styles leaking into customer HTML.
- Fixed
<!-- Vite FOUC Prevention -->comment surviving into customerdistHTML. - Fixed CSS load order and spacing in post-build HTML rewriter to match framework dist format exactly.
- Fixed several scoping and variable shadowing bugs in customer package scripts.
Affected Files
scripts/package-customer.jssrc/template-parts/theme-switcher.phpsqueditor.config.js(new optional field:customerDevDeps)
New Files
scripts/rewrite-dist-html.js
Improvements
- Refactor FOUC prevention, optimize script loading, and enhance build process for Vite development and production HTML.
- Move
uikit-components.jsto<head>and relocate FOUC script to prevent theme flicker on load. - Improve script initialization order in
head.phpandbase.php.
Improvements
- Overhaul theme engine with
$overridesand$dark-overridesSass maps for foundational, granular token control. - Introduce 4-Stage Build sequence (build:css -> build:snap -> build:zip -> build:customer) for lean, professional handouts.
- Integrate a comprehensive Theme & Typography Preset switcher into the
project-templatescaffold for rapid prototyping. - Modularize offcanvas system into a standalone
offcanvas.phptemplate part, decoupled from the header for greater flexibility. - Implement dark mode FOUC (Flash of Unstyled Content) prevention script in
base.phpto ensure seamless loading. - Reimplement theme management with separate Vite-compiled SCSS entry points for faster builds and cleaner isolation.
- Implement high-fidelity responsive heading scale (text-h2 -> text-h1 -> text-display-6) across the project scaffold.
- Add high-fidelity header parameters (
$isDark,$isFloat) for professional dynamic layout control. - Synchronize design tokens across
_config.scssand_tokens.scssfor centralized customization. - Enable professional media optimization and blur defaults in
squeditor.config.js. - Add RGB CSS variables for all color tokens to support Tailwind opacity modifiers and update related SCSS utilities.
- Refactor SCSS tokens to explicitly support light mode, extending theme-two styles to light mode.
- Enhance build script to support HTML subfolders and compartmentalized
distSubfoldermapping. - Introduce and integrate
cli-uiutility for standardized and enhanced command-line output across scripts. - Implement conditional content stripping for dev/demo blocks and enhance font asset handling across build scripts.
- Propagate framework improvements to AI skills (
.agent/skills), including specialized landing page instructions.
Refactors & Internal
- Centralize common utility functions and constants into a new
core.jsmodule for framework-wide reuse. - Improve Prettier execution logic and error reporting in the packaging pipeline.
- Refine theme switcher and unassigned theme removal regex to handle varied HTML tag formatting.
- Sync documentation with new typography token patterns and advanced
$overridesmap examples.
Bug Fixes
- Ensure heading font-weight correctly inherits from
--sq-heading-font-weighttoken across all themes. - Refine CLI experience with silent ZIP output and improved build phase headers.
Improvements
- Implement Splide auto-scroll functionality for high-end slider interactions.
- Add a new video utility for simplified video embedding and self-hosted management.
- Enhance SVG class handling to allow easier styling of icons and graphics.
- Refine UI styling across multiple components to ensure a more polished, high-fidelity look.
Improvements
- Overhaul README with clearer, more concise setup and installation instructions for new developers.
- Update directory structure documentation and add new documentation links for easier framework navigation.
- Bump package version to reflect significant internal updates and build fixes.
Improvements
- Enhance typography system by integrating CSS variables for centralized, flexible font management.
- Improve Vite’s Hot Module Replacement (HMR) for CSS to significantly speed up the development loop.
- Update project scaffolding and configuration to support the latest framework architectural features.
- Standardize component naming and styling conventions for improved consistency across pages.
Improvements
- Configure Tailwind screens and typography for more robust, high-fidelity responsive scaling.
- Introduce new container and form icon components to improve layout management and structure.
- Enhance README with detailed information about AI agent features and showcase project links.
- Update default button sizes and styling to better align with the new design system.
Improvements
- Implement GSAP animations and styling updates in the index and header, and remove the Swiper slider component.
- Add GSAP FOUC protection and enhanced timeline controls, and refactor component loading to conditionally include slider CSS.
- Centralize slider CSS generation and rename main CSS output for clearer distribution.
- Introduce page globbing for page resolution, restructure the customer package into src and dist directories, and improve framework snapshot, dev and packaging scripts
- Implement dynamic theme detection, enhance build process with improved path handling, and add safety checks for customer packaging.
- Introduce Swiper and Splide slider components with dynamic initialization, styling, and build system integration.
- Add full documentation link, remove old heading and important note, and correct build section number in README.
Bug Fixes
- Framework snapshot, dev and packaging scripts.
- Resolve issue with slider CSS not being included in the main CSS output.
Improvements
- Scaffold script now installs local framework core, utilizing an enhanced copyDirectory with an ignore list.
- Streamline Getting Started guide by removing manual clone instructions and reordering steps.
Improvements
- Adopt scoped package name, update CLI command, and enhance package metadata for publishing.
- Simplify project scaffolding by adding package.json and enabling npx command.
- Introduce a comprehensive project template with build scripts, configuration, and core assets for the Squeditor framework.
Initial Release of Squeditor Framework