Changelog

Keep track of what's new with ACSS! For details on specific features and utilities, please check the official documentation.

New
Enhance
Fix
  • 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)

    • 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.