v4.8.0
New in Vanilla v4.8.0
💅 New theming
This version introduces new theming system to Vanilla. Previous system was based on theme styling being applied on SCSS level on per-component basis. Newly introduced system utilises CSS custom properties to provide colour variables that are inherited through the whole document.
We currently support a light theme (default or via is-light
class name) that features white background, paper theme (via is-paper
class) that uses new "paper" grey background that is used on most of our new designs, and dark theme (via is-dark
class) that is being used more often in recent designs to highlight some significant pages.
🚧 Work in progress
Current release of Vanilla 4.8.0 contains the foundation work of this new theming and includes migration of most commonly used themed components. The work is not complete yet, there are still components that use the old theming system and many components not themed at all. We will continue to migrate remaining parts in upcoming versions.
We tried to make sure to keep this change backwards compatible, so hopefully it should not affect styling of existing components in any significant and unexpected way.
🎨 Default icon colour
As part of the theming we improved consistency of colours we use across themes. As a result of that the default colour of most of Vanilla icons (in default light theme) was changed to be the same as text colour (black #000
) instead of previous value of $color-mid-dark
(#666
). If you are using any custom icons this may cause inconsistencies.
For consistency with Vanilla use built-in icons, or update your icons to use $colors--light-theme--icon
(or $colors--dark-theme--icon
), depending on the theme.
🏗️ New and deprecated components
Alongside the theming work, we are also providing components to help build page sections in the new branding style, and deprecating some old components to avoid confusion.
New components include the hero section and new Suru sections, that should simplify building of the hero sections on the pages.
We also deprecated a variety of legacy strip variants, reducing the options and updating the strip component to utilise new theming.
For more details check the changelog in our documentation.
💣 Breaking changes
The (now deprecated) inverted link component was updated to support new theming. This may cause an issue that inverted link turns black when used in default "light" theme. Please add is-dark
class name for any element that changes background to dark, so that the child components would correctly inherit the theme.
🙋 Guest devs
Vanilla team was joined for a Pulse by wonderful guest developers: @britneywwc @chillkang. This release would not be possible without their contributions. Thanks!
📋 Changelog
🚀 Features
- Update strip component to new theming system by @bartaz (#4996)
- Add theme support for table component by @britneywwc (#5000)
- Update links to use new theming by @bartaz (#4997)
- Add theme support for muted text by @britneywwc (#4994)
- Update core icons to support new theming system by @bartaz (#4993)
- Add more hero suru variants by @bartaz (#4989)
- Add dark theme support to notifications by @chillkang (#4971)
- Update chips with new theming support by @chillkang (#4986)
- Update Suru to support hero sections with 25/75 and 50/50 main suru backgrounds by @bartaz (#4985)
- Add theme support for form validation by @britneywwc (#4981)
- Add theme support for search box by @britneywwc (#4987)
- Add theme support for forms tick elements by @britneywwc (#4977)
- Add theme support for forms password toggle by @britneywwc (#4976)
- Add theme support for forms help text by @britneywwc (#4975)
- Add new theme support for base forms by @britneywwc (#4974)
- Hero section by @bartaz (#4973)
- [Feature branch] Dark theme implemented as CSS variables by @bartaz (#4969)
🐛 Bug Fixes
- Fix overlap issues with sticky app layout panel headers by @bartaz (#4991)
- Update Twitter/X icon and add support for dark theme to GitHub icon by @bartaz (#4978)
🔨 Maintenance
- Fix typo by @britneywwc (#4999)
- Rename color variables for consistency by @chillkang (#4982)
- Export status color variables as CSS custom properties by @chillkang (#4979)
- Fix typo in release file by @britneywwc (#4980)
Getting Vanilla Framework
Install with NPM: https://www.npmjs.com/package/vanilla-framework
Visit the documentation at https://vanillaframework.io/docs
New Contributors
- @chillkang made their first contribution in #4979
Full Changelog: v4.7.0...v4.8.0