Angular 21 Support (SKY UX 14)

[Blackbaud-KerryCampbell]

How to update

To update your project to the next version of Angular and SKY UX, run the following command.

ng update @angular/core @angular/cli @skyux/packages

For an overview of changes in Angular 21, see the Angular update guide. For a full list of breaking changes, review the changelog.

Style upgrades for visual quality and dark mode readiness

SKY UX 14 includes new style guidelines and a significantly expanded style API covering spacing, borders, color, and typography. The intent is to reduce the volume of custom CSS written in applications — many CSS rules either duplicate what the API already provides or use hard-coded values that will break as styles change or new user modes are introduced. Consumers should begin using the new guidelines and API classes in place of custom CSS, particularly for color, which will be the most impactful area when dark mode support arrives.

Drag-and-drop modernization

SKY UX 14 replaces the third-party dragula library with Angular's official CDK drag-and-drop across the Grid, List, and Tile components. This reduces the dependency on an unmaintained package and aligns drag-and-drop behavior with the Angular ecosystem.

Animation architecture overhaul

A significant number of components have moved from Angular's animation framework to pure CSS transitions. Affected components include Split View, Flyout, Tabs, Popovers, Inline Form, Text Expand, Lookup, and several others. For most projects this will be a transparent change, but any code that programmatically interacts with Angular animation events on these components — or disables animations via BrowserAnimationsModule — will need to be reviewed. Verify animation behavior in your testing environment after upgrading.

Deprecated CSS classes and custom properties replaced

To align with the latest design tokens, deprecated CSS class names and custom property names have been updated across the codebase. A migration schematic automatically handles these replacements across HTML, TypeScript, and SCSS files.

AG Grid 35 support

The latest version of AG Grid has been adopted, including an updated date picker experience in column filters. For more information, see the AG Grid 35 changelog.

Deprecated components to be deleted in v15 (Sept 2026)

In an effort to reduce redundant code and improve accessibility, the following components will be deleted in v15. Use of the labelText inputs on parent components enables a number of accessibility features and is the supported replacement for the Label/Header components listed below.

• SkyCheckboxLabelComponent
• SkyBoxHeaderComponent
• SkyRadioLabelComponent
• SkyToggleSwitchLabelComponent
• SkyFileAttachmentLabelComponent
• SkySelectFieldComponent

See the deprecation documentation for migration guidance.

Deprecated components to be deleted in v16 (Mar 2027)

• SkyDefinitionListComponent
• SkyPageSummaryComponent

Migration guidance is available in the deprecation documentation.