<aside> 🚨 Important (Before Update) Read the changelog (RTFM) so you know what to expect when you update.

</aside>

<aside> 🚨 Important (After Update) After you update to a new version you should open the ACSS dashboard, switch to any different tab, and then click “Save Changes” in order to regenerate stylesheets. This can help shake loose certain stylesheet-related issues.

</aside>

<aside> 💡 Caching can make it seem like things are broken when they really aren’t. Always clear all caches, including Cloudflare, before submitting a bug ticket.

</aside>

2.3

New
- Customize box shadow names
- Customize box shadow values
- Box shadow variables
  - var(—box-shadow-{name})
- Added reference color swatches for every shade in the ACSS dashboard (Edit Shades dropdown)
- Added HSL reference values for main colors in the ACSS dashboard (Edit Shades dropdown)
- Added Hue inputs for all color shades for ultimate fine tuning of shades (Edit Shades dropdown)
- Variables for color partials (all colors)
  - —{color}-hex (references the hex code for the color)
  - —{color}-hsl (references the hsl value string for the color)
    - Especially valuable when creating custom transparencies… background-color: hsl(var(—primary-hsl) / .22) = your primary color at 22% opacity.
  - —{color}-rgb (references the rgb value string for the color)
  - —{color}-h (references the hue value for the color)
  - —{color}-s (references the saturation value for the color)
  - —{color}-l (references the lightness value for the color)
  - —{color}-r (references the “r” value for the color)
  - —{color}-g (references the “g” value for the color)
  - —{color}-b (references the “b” value for the color)
- Admin Bar height variable
  - var(—admin-bar-height) to replace the obnoxious clown show WP default variable that nobody can ever remember: var(--wp-admin--admin-bar--height)
- Set text line lengths for every text size.
  - You can now control the line length for every text size.
- Set line height for every text size.
  - You can now control the default line height for every text size.
- Boxed Layout Setting
  - Under “Viewport” you can now choose to enable a boxed layout for your website.
  - Website background color is now in this panel (was previously in the typography tab).
  - Set the website background color and device/browser background color separately.
  - Set a boxed layout width
  - Define a box shadow for your boxed layout
  - Set a top margin for your boxed layout (if you want a more 3 dimensional boxed layout effect)
  - Define borders for your boxed layout (width, color, style).
- Offset Page Content Automatically
  - New toggle under Additional Styling > Header Styling called “Offset Page Content Automatically.”
  - Automatically offset your page content when using a sticky or fixed header.
  - Also offsets the initial “add element” controls in Bricks’ canvas (so you can still interact with them).
- .form—light now works to style Bricks’ native search form.
- .form—light now works to style Oxygen’s native search form.
- New ‘Help Text’ styling in WS Form Integration (Beta)
- Pro Mode
  - Turns off all but the most important framework classes. Retains all variables. Lightens the framework load by around 50%. Designed for advanced users who mostly use custom classes and variables.
  - When Pro Mode is activated, and unused buttons and colors are turned off, the framework is up to 85% lighter.
  - Doesn’t remove classes from the auto-suggest / builder database yet. We’re working on a way to do that safely.
Enhancement
- Turning off parts of the framework will now only turn off classes associated with that part of the framework. Variables will still work, allowing advanced users to lighten the framework by disabling classes while still using those parts of the framework via variables.
- Consolidated “Text Styling” into the main Text panel in Typography
- Consolidated “Heading Styling” into the main Headings panel in Typography
- Moved “Fix Paragraph & Spacing” option to Options panel
- var(—header-height) now auto scales down through all breakpoint values so you don’t have to reference the breakpoint variables in your custom code.
Fix
- Fixed issues with var/calc expansion expanding links, aspect ratios, and breaking pseudo element colon spacing in CSS, etc
- Fixed an issue with scroll offsets not respecting the breakpoint values
- Object fit classes now work when images are wrapped in <figure> tags
- Fixed —btn-width missing a unit on the value.
- Fixed fatal error when activating the plugin via WP CLI
- Bricks Form Integration (Beta)
  - Fixed Checkbox alignements
  - Fixed File Upload button style
- WS Form Integration (Beta)
  - Fixed Input border style not working
  - Fixed wrong Input Phone field padding
  - Fixed Placeholder text color + text opacity not working
  - Fixed Range Slider background colors
  - Fixed Checkboxes + Radios background color
  - Fixed Radios border color not working
  - Fixed Submit button border style
  - Fixed checkbox label color
  - Fixed Datetime picker gets Action color (not supported in Firefox)

2.2.0.2

Enhancement
- Added the new contextual variables to builder autosuggest.
- Added white, black, and transparent to Global colors palette in Bricks
Fix
- Adjusted .clickable-parent functionality to make sure it works on text links.
- Made an adjustment to automatic var expansion to fix the bug where it interpreted variables such as .grid—3-2 as a formula instead of just a variable.
- Fixed an issue where text selection color wasn’t showing up in Firefox when the text selection color input in ACSS was reset to blank.
- Fixed an issue where the deprecated contextual utilities in Frames (prefixed with “fr”) were overriding the new contextual utility values.

2.2.0.1 - Hotfix

Fixed a “Kevin is a moron” issue that was preventing changes to the new contextual variables from the dashboard.

2.2.0

New
- Grid variables
  - All supported grid structures, up to 12 columns, and including auto grids.
- Contextual variables & classes
  - var(—container-gap), var(—content-gap), var(—grid-gap)
  - .container-gap, .content-gap, .grid-gap
  - Editable from dashboard
  - Backwards compatible with Frames contextual utilities
    - Replaces Frames contextual spacing utilities.
- Automatic variable expansion (Merry Christmas!)
  - Typing a variable, starting simply with “--” and then hitting <enter> will auto-wrap your variable with var(). This works in all input fields in Bricks and Oxygen and saves a tremendous amount of time/typing.
  - In CSS and code blocks, a semicolon “;” is the trigger for expansion rather than <enter>.
  - This feature must be turned on in ACSS options panel. Please note that it’s almost impossible to account for all scenarios out of the gate, so we are going to need to fine tune this feature over time to perfect it.
- Automatic calc expansion (Merry Christmas!)
  - Typing a calculation (e.g. 5 + 5) and then hitting <enter> will auto wrap the formula in a calc(). This auto expansion can be combined with variable expansion, For example, e.g. —text-m * 1.25 will produce calc(var(—text-m) * 1.25). This works in all input fields in Bricks and Oxygen and saves a tremendous amount of time/typing.
  - In CSS and code blocks, a semicolon “;” is the trigger for expansion rather than <enter>.
  - This feature must be turned on in ACSS options panel. Please note that it’s almost impossible to account for all scenarios out of the gate, so we are going to need to fine tune this feature over time to perfect it.
- Calc/Variable validation
  - When using a calc or variable in an input field or code block, ACSS will validate the string to ensure it has the proper number of closing brackets. Malformed variables (missing brackets) are a big problem in web design and can result in broken stylesheets that break all site styling. Thus, we’ve put in a validation check to ensure that any time you use variables or calcs, they have the proper number of brackets.
  - This feature must be turned on in ACSS options panel. Please note that it’s almost impossible to account for all scenarios out of the gate, so we are going to need to fine tune this feature over time to perfect it.
Fixes
- Fixed an issue with the licensing system of both ACSS and Frames when the WordPress site_url contains a directory
- Fixed the tooltip for the Bricks style guide remote template URL
- Skip links now default to the new action color rather than primary.
- Fixed some input styling not working for Bricks’ native form element.

2.1.4

November 29, 2022