Releases
For the Minerva Web Framework
v1.6.1
Released: 2025-08-27
Enhancements
- Added a component wrapper to the carousel (#598)
- Added an advanceType prop to the carousel to control the behavior of slide navigation (#598)
- Disabled carousel autoplay on touch devices (#600)
- Changed the page search behavior to scroll the result to the top of the page rather than the middle (#599)
Bug Fixes
- Fixed a bug where clicking the next button on the last page of a carousel with a number of slides that isn't evenly divisible by the number of pages would break the navigation of all other buttons. (#598)
- Fixed an issue with the page search component where it would scroll past the target result (#599)
v1.5.1
Released: 2025-06-25
v1.5.0
Released: 2025-05-27
New Features
- Added support for dark mode to the design system (#524)
- Dark mode can be enabled for non-wordpress web applications by adding the class
ua_color-mode--dark
to the same element asua_minerva
- Updated the BrandFooter and BrandBar components to use static colors from the color reference tokens, this ensures they retain all color settings regardless of color mode
- Dark mode is not supported in the WordPress theme at this time
- Dark mode can be enabled for non-wordpress web applications by adding the class
- Added new variable
link-accent
used for applying accent color to links and navigational elements where text contrast would fail. These mostly apply to borders and underlines (#540)
Enhancements
- Updated the design of the SiteFooter component for high contrast and dark mode (#524)
- Updated the colors of duotone icons for better accessibility contrast (#542)
- Adjusted some code block syntax highlighting colors for better accessibility contrast (#524)
- Changed the value of a number of CSS color variables to better meet contrast requirements in all color contexts (#540)
- Updated the design of the ContactCard component (#551)
- Increased the border thickness of the LinkBox component by 1px (#564)
- Changed the color for site title to crimson to better indicate it's behavior as a link (#540)
Bug Fixes
- Fixed an issue where the CodeBlock component was not keyboard accessible with horizontal scrolling (#533)
- Fixed an issue where the "new tab icon" on links in the primary navigation would break to the next line (#561)
- Fixed an issue where content such as links in the description of a Card could not be selected or activated if the Card itself was setup as a link (#564)
Breaking changes
The HTML for the following components has been modified, and those changes will need to be reflected in any web applications using static HTML with Minerva CSS:
These changes are only relevant to users extending minerva with custom CSS
- Changed the name of two CSS variables
ua_color-icon--primary
is nowua_color-icon--duotone-primary
ua_color-icon--secondary
is nowua_color-icon--duotone-secondary
Internal notes
These changes are only relevant to users working with Minerva directly as a development resource
- Major refactor to how design tokens are handled (#524)
- Move token maps to JS objects to be accessible to JS projects
- Added a script to transpile the JS objects into SCSS maps
- Updated the storybook toolbar to add an option for setting the color mode
- Changed how the ua_minerva class is added to storybook stories using a decorator
- Updated the storybook configuration to omit decorators from the html plugin
- Changed the media criteria "reduce-motion" because its a media query to put motion in to respect user motion preference. (#524)
v1.4.2
Released: 2025-03-04
Enhancements
- Added underline to Card component headings where the Card is linked
Bug Fixes
- Adds the 'use client' directive to components that call React
useEffect
, which should allow Minerva to be used with setups that utilize SSR without error. See React Documentation - Fixes an autoprefixer warning related to an alignment property in the Event component. It now uses
flex-start
instead ofstart
for alignment.
v1.4.0
Released: 2024-09-24
New Features
- Added a new
ContactCard
component (#477)
Enhancements
- Added an active state for
SecondaryNavigation
menu items (#503) - The
SecondaryNavigation
menu will automatically expand to show the active item if the active item is a child (#503) - Added a subtle style for the Event component (#502)
Bug Fixes
- Addressed an issue with h1 alignment, adding new props
titleAlign
andtitleWidth
to the Page component, and removing some aggressive CSS (#495) - Fixed an issue where the TitleBar title would have a larger clickable area than intended. (#504)
- Fixed an issue where the expander in the TitleBar could wrap to the next line in edge cases (#504)
Deprecations
- The
CallToAction
has had the text prop deprecated in favor of the children prop. The text prop will still work, but will display a warning in the console. A warning will also be shown if the children prop is undefined, as it will be made a required prop in a future version, when the text prop is removed completely. (#477) - The
Card
component has had the description prop deprecated in favor of the children prop. A warning will be provided if the description prop is used, and the description prop will be removed completely in a future version. (#477)
Maintenance
- Updated Storybook and made slight changes to the project directory structure (#492)
- Moved the FA Icon generator to it's own repository (#492)
- Introduced snapshot testing (#494)
- Overhauled the build and dist scripts to enable more consistent release workflows (#497)
HTML Changes
- The h1 in page layouts should now be wrapped in an element with a layout class, such as
ua_layout--standard
See (#495) - A new wrapper div has been added in the
TitleBar
component, wrapping around the title bar content and expander button. See (#504) - The "Accessibility" link in the universal footer has been updated to point to
https://accessibility.ua.edu/statement/
. See (#505) - In the
SecondaryNavigation
component, thearia-current
attribute should be added to the active page's<a>
element. The resulting html should look something like<a href="..." aria-current="true">
See (#503)
v1.3.3
Released: 2024-08-29
v1.3.2
Released: 2024-08-19
v1.3.1
Released: 2024-07-25
Enhancements
- Updates the space between the content and sidebar to be
gutter
instead ofgrid-gap
- Updates layout width variables, specifically the wide width layout, which is now a calculation of the combined layout widths instead of being hard coded
- Added some redundant styling to the Pullquote component to enforce text alignment
Bug Fixes
- Adds
justify content: center
to the content wrapper insideua_app
- Revamps list spacing so that the indentation is applied more predictably
v1.3.0
Released: 2024-07-19
New Features
- Added a new variable
ua_space--flex-gap
(#458) - Added a new wrapper
#ua_app
that will allow short pages to fill the available viewport height (#466)
Enhancements
- Added
showLocation
prop to the EventFeed component to allow the locations to be toggled off (#447) - Updated the time format used in the Event component to respect AP style (#448)
- Added an
open
prop to the Details component, allowing users to set the default state (#453) - Updated the style for the Pullquote component to match the design system mockup of this component (#452)
- Updated the text color on the AlertBanner component to use negative text color (#456)
- Made the AlertBanner
href
prop optional (#456) - Removed default style for the
fieldset
html element (#457) - Updated the value of
ua_space--flow-half
andua_space--flow-double
to be a calc function ofua_space--flow
(#457) - Changed the background and text colors on positive, negative, and info contexts inside "most contrast" sections (#458)
- Changed the background colors on positive, negative, and info contexts inside "more contrast" sections (#458)
- Updated FontAwesome to 6.6 (#467)
Bug Fixes
- Removed the outbound link icon from the UA System Logo (#445)
Deprecations
- The Accordion block has been renamed to Details. This is for better language parity between minerva and the wordpress theme (#453)
- The Blockquote component has been renamed to Pullquote. This was done to avoid confusion with the blockquote html element and to provide more parity to component names between the wordpress theme and minerva framework (#452)
- Removed
ua_space--gap
in favor ofua_space--grid-gap
(#458) - Removed
ua_color--text-inverse
in favor ofua_color--background-surface
(#458) - Removed
ua_color--background-disabled
in favor ofua_color--background-chip
(#458) - Removed the following components: DefinitionListItem, Video, Image. Please use plain HTML instead (#465)
Other notable changes
- Removes advanced styles from the blockquote html element allowing it to be used as a simple quote with no class name requirements (#452)
- Changes the markup of the new Pullquote component to apply styles more intuitively based on HTML markup rather than require additional wrappers and class names (#452)
- Added the
ua_
prefix to the classesmedia-wrapper
andvisually-hidden
(#457) - Added a
$scope
SCSS variable to allow custom builds of Minerva with different global scope (#462) - Moved list styles to placeholder selectors that can be extended to any other selector (#462)
v1.2.0
Released: 2024-05-06
New Features
- Updated the Font Awesome CSS to support duotone icons (#415)
- Added a prominent style for the LinkBox component (#415)
- Added a
type
prop to the Icon component that enables duotone icons (#415)
Enhancements
- Redesigned the accordion component (details/summary) (#413)
Deprecations
- Removed the
isBrand
prop from the Icon component, usetype
instead (#415)
v1.1.0
Released: 2024-04-25
New Features
- Added utilities for text and background color (#397)
- Added a "sidebar" area to the page layout grid (#406)
- This grid area will display below the page content on smaller viewports while the sub-nav grid area will continue to display above the page content
Enhancements
- Updated Font Awesome to 6.5.2 (#391)
- Overhauled how the primary menu expander behaves (#402)
- The sub menu will only display on hover with fine cursor input
- Hovering over the expander will no longer open the sub menu
- The menu should now be able to be closed by clicking on the expander, even on devices with fine cursors
- The sub menu should now be collapsible on mobile
- Added a small crimson border to the top of the site footer (#404)
- Added a border on hover to standard cards that have a link to show that the entire card is clickable (#405)
Bug Fixes
- Removed some styles specific to SVG images causing unexpected behavior (#401)
Deprecations
- Removed the "footer" grid area from the
Page
component layout as it wasn't being used.
v1.0.1
Released: 2024-03-29
Enhancements
- Added a new media breakpoint for text. This should help display longer words on smaller viewport widths without needing hyphenation. (#383)
v1.0.0
Released: 2024-03-21
v1.0.0-rc.2
Released: 2024-03-21
v1.0.0-rc.1
Released: 2024-03-20
New Features
- Added the
AlertBanner
component (#375) - The distribution now includes the core SCSS file, so you can import it into your own SCSS projects to use the same functions and mixins as minerva (#376)
Enhancements
- Removed letter spacing from text utilities (#376)
- Fixed inconsistencies in text utility class names (#376)
Deprecations
- Removed deprecated typeset variables (#376)
v1.0.0-beta.3.1
Released: 2024-03-08
v1.0.0-beta.3
Released: 2024-03-08
New Features
- Added design tokens for font size (#361)
- Added design tokens for line height (#361)
- Added new color variable
--ua_color-text--subtle
(#365) - Removed the bold styling from parent menu items in preparation of adding active page styles (#367)
Enhancements
- Adjusted the gap between primary nav menu items (#358)
- Moved esm components to top level so they can be imported from
minerva/src
(#359) - Added a border to the CTA component to match the height of it's subtle variant (#361)
- Increased the contrast of disabled buttons (365)
Bug fixes
- Fixed an issue where the Link component would be styled incorrectly when the
className
prop was not passed (#360) - Fixed an issue where buttons may not be styled correctly (365)
- Fixed an issue where the navigation elements
TitleBar
andPrimaryNavigation
would be hidden if Javascript failed or was disabled. (#363) - Fixed an issue where the navigation element
SecondaryNavigation
would have inaccessible children if javascript failed or was disabled (#363) - Fixed an issue where the expander of SecondaryNavigation would wrap to next line instead of the link text. (#367)
Breaking changes and deprecations
- Changed the name of
--ua_space--0
to--ua_space--05
for better transparency (#361) - The old typeset variables are deprecated and will be removed in the next version. Consider switching to the new line height and font size variables (#361)
- Removed
ua_color-text--disabled
effective immediately. Use--ua_color-text--inverse
instead (#365) - Removed
ua_context--subtle
since its only purpose was to get subtle style callouts. We'll add these as component variants in the future (365) - Renamed
ua_context--elevated
toua_contrast--more
(365) - Renamed
ua_context--prominent
toua_contrast--most
(365) - Changed the
presence
prop on the Group component to becontrast
with accepted values "more" and "most" (365) - Markup for the
TitleBar
,SecondaryNavigation
andPrimaryNavigation
have changed (#363, #367)
v1.0.0-beta.2
Released: 2024-02-27
New Features
- Added a bunch of utility classes (#331)
- Added subtle variant for the CallToAction component (#337)
- Added a disabled state to the CallToAction component (#337)
Enhancements
- Updates the to TagList component to improve styling (#326)
- Improved behavior
of ua_layout--flow-half
(#331) - Added a background to the link list items, which should improve their use on top of complex backgrounds (#338)
- Adjusted the props of the CallToActionList component, improving justification and classes (#342)
Bug Fixes
- Fixed a bug where flow spacing was not being applied to Step components (#335)
- Fixed an issue where the TagList would overflow the container instead of wrapping (#340)
- The CodeBlock will no longer wrap long lines, providing a horizontal scroll bar instead (#351)
- Fixed an issue where the TitleBar menu wouldn't display (#350)
Other notable changes
v1.0.0-beta.1
Released: 2024-01-24
New Features
- Added the
CallToActionList
Component (#318)
Enhancements
- Update FontAwesome from 6.4.1 to 6.5.1 (#321)
Bug Fixes
- Fixed an issue with incorrect margins on horizontal cards with the subtle presence (#320)
- Fixed an issue with horizontal card image sizes (#310)
- Moved presence class to wrapper div to improve compatibility with wordpress (#317, #312)
- Fixed a bug where images were being sized incorrectly in a Grid (#316)
Deprecations
v1.0.0-alpha.10
Released: 2023-12-01
Features
- Added several utility classes related to spacing (#292)
ua_space--flow-double
ua_space--section
ua_space--0
ua_space-start--flow-double
ua_space-start--section
ua_space-start--0
ua_space-end--flow-double
ua_space-end--section
ua_space-end--0
Enhancements
- Redesigned the primary navigation dropdown on large viewports (#300)
- Significant refactor of the layout system. This fixes numerous bugs and layout issues but also introduces a few changes to be aware of. (#292, #303, #304)
- Added the
ClassName
prop to all components (#292) - Added a component wrapper to the
LeadText
component (#292) - Added header and footer options to the
Group
element
prop (#292)
Breaking changes
- The class name
ua_align--standard
changed toua_width--standard
- The class name
ua_align--wide
changed toua_width--wide
- The class name
ua_align--full
changed toua_width--full
- The class name
ua_layout_flow
changed toua_layout--flow
- The class name
ua_layout_grid
changed toua_layout--grid
- The class name
ua_layout_flex
changed toua_layout--flex
- The class name
ua_layout_standard
changed toua_layout--standard
- The class name
ua_layout_wide
changed toua_layout--wide
- All prop names dealing with component alignment has been renamed from
align
tojustify
except in cases where the alignment is strictly text alignment
v1.0.0-alpha.9
Released: 2023-11-09
Features
- Added
Tag
andTagList
components (#267) - Added landscape option to the
Card
component (#244) - Added
EventFeed
component (#293)
Enhancements
- Updated Font Awesome to 6.4.2 (#266)
- Added the align prop to the Heading component (#293)
- Use text/accent color where possible for better accessibility in prominent contexts (#291)
Bug Fixes
- Fixed a bug where LinkList items would not expand to fill the height of wrapped lines (#262)
- Changed the color of DataHighlight to use
text/accent
color (#263) - Fixed an issue where the event name size would change depending on the heading level (#293)
- Fixed an issue where the event component would display the full date range even if the event ends on the same day as it starts (#293)
- Fix specificity of lead-in selector (#291)
Other Changes
v1.0.0-alpha.8
Released: 2023-10-12
Features
- Re-Added the Steps component with new design (#251)
- Now supports nested lists (#256)
- Added a Swatch component (#254)
Enhancements
- Adjusted section spacing on smaller screens (#252)
- Redesigned the Event component (#249)
- Optimized distribution for core brand UI (#247)
Bug fixes
- Adjusted the link styling for better state indications in sections with prominent context (#250)
- The Event component now accepts a
heading_level
prop (#248) - Updated the syntax highlighting colors to be more accessible (#239)
- Changed LinkList layout to Grid and LinkList will now accept Grid props (#238)
- Added a missing export for SocialLinks (#238)
- Tweaked the color value of Primary 300 to be more accessible (#242)
- Adjusted the CSS so that alignment props will work correctly (#253)
Breaking changes
- Changed how we handle variable value shifts, these will now be controlled by
ua_context--prominent
,ua_context--elevated
, andua_context--subtle
(#245)
v1.0.0-alpha.7
Released: 2023-09-08
New Features
Enhancements
- Updated several components to make them compatible with NextJS (#203)
- Added a subtle Card variant (#206)
- Updated all colors in the color system (#210)
- Adjusted typography on the Steps pattern (#211)
- Updated the typography on the Card component (#229)
- Updated the Accordion
open
visual (#233)
Bug Fixes
- Fixed a bug where the sidebar menu background was displaying incorrectly for nested items (#207)
- Added bottom margin to sidebar in the Page component (#221)
- Removed space below brand footer (#221)
- Added LeadText to the package exports, allowing it to be used in projects (#221)
- Updated the padding on the LinkBox icon (#221)
- Fixed several accessibility errors in the TitleBar and SearchBox components (#218)
- Set hero text to allow hyphenation (#218)
- Fixed list item alignment on the Page component (#231)
Breaking Changes
v1.0.0-alpha.6
Released: 2023-08-01
New Features
- Added a
Breadcrumbs
component (#158) - Added a
CodeBlock
component (#106) - Added support for Prism JS
- Added a new
Pagination
component (#191) - Added a new
SocailLinks
component (#188) - Added a new
LeadText
components (#195)
Enhancements
- Overhauled the built distribution. You can now cherry pick CSS files as needed, and internal project components are no longer included in the package (#182)
- Added a
subTitle
prop to theCard
component (#178) - Added aspect ration options to the
Card
component (#178)
Bug Fixes
- Fixed an issue where
Group
background image wasn't filling 100% width (#170) - Fixed an issue where content in the hero area of the
Page
component didn't get the correct gutter padding (#174) - Fixed an issue where sidebar items could wrap on hover (#177)
- Fixed an issue where hero text wasn't aligned correctly (#184)
Known Issues
- List bullets/numbers are slightly cut off by the edge of the viewport on small viewport widths (#189)