Changelog
Keep track of what's new with ACSS! For details on specific features and utilities, please check the official documentation.
- November 14, 2024
3.2
Attention: This update contains a lot of refactoring to dashboard interactions, including pinning, live preview, calculations, and validation. It has been extensively tested, but we recommend updating on a staging server first and verifying the update before updating on production. If you do update production and encounter issues, it’s perfectly safe and easy to roll back to the previous version. Make sure you report any issues you encounter to our team in the community.
Card Framework (Experimental)
A powerful new framework for managing card styling across your project.
Icon Framework (Experimental)
Users can easily control the global styling of icons now and manage custom icon styling easier at the template, page, box, and single-icon levels.
Completely refactored dashboard docking, pinning, and resizing
It should now be impossible for the dashboard to appear off the screen and the dashboard position will be re-checked every time the window size changes. Additionally, docking and pinning is much more accurate and dashboard height is sticky.
Minor UI/UX enhancements
- The dashboard header is now sticky
- There’s a back button when searching
- Search accordions reveal additional details
Custom SCSS panel is now fully resizable
Users can now drag either side of the dashboard to make it wider when the custom SCSS panel is open.
Updated most important components and logic to Svelte 5
Cleanup and standardization.
Refactored settings logic for better maintainability
Cleanup and standardization.
Padding Breakpoint Classes
You can now change padding at breakpoints with padding utility classes.
Expanded Opacity Values (Increments of 5)
Opacity classes have moved from increments of 10 to increments of 5.
BREAKING: Remove Link Color Manipulation From Contextual Text Color Classes
.text--dark
and.text--light
(and similar) used to alter the color of links also. This was deemed undesirable by users, so we’ve removed this. These classes will no longer change your link color. You can still change link color using.link--
classes.Refactored: Centering Classes
Cleanup and standardization.
Added Centering Mixin
You can now easily center content with the powerful new centering mixin.
Refactored: Display Classes
Cleanup and standardization.
Refactored: Margin Classes & Added Block/Inline Classes
Cleanup and standardization, plus added
.margin-block--
and.margin-inline--
classes to round out the options with margin classes.Refactored: Visibility Classes
Cleanup and standardization.
Refactored: Position Classes
Cleanup and standardization.
Re-organized: Spacing Classes
File system cleanup and standardization.
Form Fixes
- Inline-start padding for phone fields
- Removed padding bottom default that was causing issues in Bricks forms
- Removed duplicate border-color property in Bricks checkboxes
MINOR VISUAL CHANGE: Fixed an issue with mobile padding calculation for XS and S sizes
The XS and S spacing sizes were dividing by the desktop spacing scale value instead of the mobile spacing scale value. This issue has likely been present since the mobile scale was introduced over 2+ years ago.
Overall, this is a minor issue and any visual differences on mobile should be imperceptible to real users. In fact, it’s so imperceptible that nobody has reported it over this time period.
We’re talking a 2-3 pixel difference in small padding, gap, etc. The fix will actually make your mobile padding more accurate to what you were wanting in the first place, but again, is imperceptible to anyone who doesn’t know what the actual calculated values are supposed to be.
- October 31, 2024
3.1.5
This is an enhancement and bug fix release as we continue to put most of the focus on progress for the Card Framework.
Apply heading color relationships to heading utility class variables (h1-h6)
Enhance auto color relationship compatibility for headings
Auto color relationships can now override default heading colors while still remaining changeable by custom classes and text color utilities.
[Internal] Change variables module to tokens
More Card Framework Progress
[Internal] Replace rollup with vite for bundling
Fixes for texture/overlay live preview and tooltips
[Form] Fixed a label in forms settings for consistency
[Form] Fix for border-width tokens missing 'rem' unit
Fixed texture and overlay tooltips for accuracy
- October 25, 2024
3.1.4
Textures & Overlays has graduated out of "experimental"
Textures & Overlays is now an official feature.
Initial foundation for the ACSS Card Framework (Experimental)
We’re building a complete, official framework for managing shared card styles. You’ll see a new Cards dashboard with a toggle switch, but this is only the start of this feature. It’s not yet ready for testing.
Textures & Overlays now support animation
You can now animate textures with CSS (think gradient animations and more).
New fluid() function for generating clamp functions on the fly
In ACSS custom SCSS area, you can create custom clamps for any use case with
fluid()
. The function accepts a min and max pixel value (unit not required), separated by comma, e.g.fluid(20,28);
.New .smart-spacing--off class for cancelling smart spacing on any box/page/template
You can now selectively cancel out smart spacing anywhere.
Overflow Detection
ACSS now has an overflow detection mode to visually indicate elements that are creating horizontal overflow.
API file for every builder for better maintainability
Upgraded to Svelte 5
Added labels to the color hex and hsl inputs in dashboard
Added picture tag to figure smart spacing targeting
Smart spacing will now apply to
<picture>
elements the same way it applies to<figure>
elements.Set auto grids to 100% width by default
Some users were using auto grids on divs with no defined width, resulting in the auto grid auto collapsing. 100% default width fixes this.
Specificity adjustment for heading classes
Expanded border classes
All sides are now independently available as well as border-block and border-inline and all are available in default, light, and dark.
Defined new CSS vars for forms
Change default root font size to 100%
ACSS will now default to 100% root font size on fresh installs (existing installs unaffected).
Various improvements for contextual relationships
Dividers now use ::after element instead of ::before
This improves compatibility with overlays.
Removed 0 value avoidance for declaring header height
Header height is now output as a variable even if a value of 0 is used.
Output all global link styles as variables
You can now freely use these global tokens anywhere.
Add divider and new border classes and vars to auto suggest and context menus
Added divider classes to auto suggest and context menu
Fluent Forms: Override default fixed gap with --f-grid-gutter
Various fixes for contextual relationship link/heading colors
Fix for context menus not filling 100% of width for some users
Sticky offset fallback value fix
Sticky was falling back to a variable, which, if undefined, was resulting in no fallback value rendering sticky elements non-sticky. This is now fixed.
Change color picker to default when alt color is turned off.
Revert smart spacing normalize for everywhere
An adjustment to smart spacing to address a Gutenberg issue was causing erroneous spacing in certain scenarios. We’ve reverted this for now.
- October 18, 2024
3.1.3 (3.1.3.1)
This version was released as 3.1.3.1. The changelog is the same for 3.1.3, but we added an extra build step to account for one additional fix.
Textures/Overlays now support background-repeat
You can now control the background-repeat property for textures and overlays.
Overlays now support blend mode
You can now set blend mode for custom overlays.
Textures/Overlays has now been expanded to five slots/options
You now have 5 options instead of 3 for custom textures/overlays.
Added a function to parse a css string into a map
Internal mostly.
Added interpolate-size allow keywords for animating keyword values like auto
This is a progressive enhancement for animating keyword values like auto, max-content, etc.
Improved auto color relationship compatibility with color scheme
Auto color relationships should be fully compatible with color scheme now.
Added color scheme support to custom textures and overlays.
Auto color relationships should be fully compatible with custom textures and overlays now.
(Breaking Change - Experimental Feature): Texture/overlay utilities now use a single dash instead of double
If you’ve been experimenting
Decoupled config files and improved test coverage on Recipes API
Fixed auto quote wrapping for asssets on texture/overlays 2-5
You no longer need to add quotes around values manually on textures/overlays two through five.
Increased specificity on heading classes to battle specificity issues
Prevent dashboard crash when pinning
When the user opened the dashboard for the very first time, the acss_dashboard_position was not set. So when the user pinned the dashboard and refreshed the page, the code tried to read the acss_dashboard_position (what is null) and crashed. This is fixed.
Prevent overflow on certain context menu sections [314]
Max-height issue fixed.
Additional fixes for hover shade generation
add migration for bg[shade]-link, bg[shade]-link-hover and bg[shade]-button settings
- October 13, 2024
3.1.2
This release was packaged up to coincide with the release of our official Textures & Overlays demo video to ensure users who want to experiment with that feature have all the same options available to them.
Support for Using Textures as Overlays
You can now use a Texture Style as a background AND as an overlay. ACSS will generate .overlay– classes for each Texture style if you turn on the overlay option.
Additional Texture/Overlay Features & Enhancements
Some new controls and refinements have been added.
Conditionally Load Code for Textures & Overlays
Textures & Overlays will not load any code unless an asset is declared. Even if the feature is turned on, no code is loaded unless you’ve defined an asset for the specific Texture you’re creating. You’re free to leave this feature on at all times with blank assets and it will have zero impact on performance.
Specificity Adjustments for Heading/Link Styles in Color Relationships
The specificity was a little too specific, so we’ve reduced it to the minimum required to work.