# Framework v3.1.1

Released on 2026-05-01.

## Framework Changes

- Added a factorized utility engine for shared token selectors, responsive gates, orientation gates, bit-depth gates, and dark-mode gates.
- Reworked `bg--*` and `text--*` utilities to bind CSS custom properties once per token and apply paint rules through grouped selectors.
- Reworked spacing utilities so margin and padding token bindings are generated once across size and orientation variants.
- Reduced generated stylesheet weight while keeping existing utility class names and variant behavior intact.
- Updated the plugin render runtime alongside the CSS release.

## Upgrade Notes

- No markup changes are required. Existing Framework 3.1 utility classes continue to work.
- Use this patch for the smaller generated stylesheet while keeping the Framework 3.1 TRMNL font defaults.

## Documentation Changes

- No separate documentation changes shipped with this stylesheet-size patch.