Changelog

3.0.0 (2026-07-09)

BREAKING CHANGES

drop Icon wrapper and re-export lucide icons directly

• Icon, iconNames, IconName, and IconSize are removed. Import icon components directly from @falcon/ui-kit — every lucide-react export ending with Icon is now re-exported from the package (e.g. import { BellIcon } from "@falcon/ui-kit").
• The custom ag-field icon is now exported as FieldIcon instead of AgField.
• SidebarCollapsedFlyout, SidebarCollapsedFlyoutItem, SidebarNavLabel, SidebarNavExpandIcon, useSidebarFlyout, and sidebarMenuButtonVariants are removed from the public API.

Fixes

• drop Icon wrapper and re-export lucide icons directly

2.3.1 (2026-07-07)

Documentation

• publish documentation inside the package

Features

• sync design tokens from Figma

2.3.0 (2026-06-29)

Features

• add AppHeader, AppLayout, and Sidebar components

2.2.1 (2026-06-25)

Fixes

• import tokens

2.2.0 (2026-06-24)

Features

• compile tokens from a DTCG JSON file

2.1.0 (2026-06-12)

Documentation

• add AI-first governance documentation set
• remove AGENTS.md, route consumer protocol through llms.txt
• fold in review feedback from Daniel and Niels

Features

• add Icon component with Lucide + custom-icon catalog
• consolidate Icon ADRs, finalize API, add receipt
• add 8 Lucide icons for Maverick sidebar

2.0.1 (2026-05-26)

Documentation

• migrate away from storybook to astro

2.0.0 (2026-05-13)

BREAKING CHANGES

new design system

legacy components have been moved into a separate "@falcon/ui-kit/dist/legacy" entrypoint.

Features

• new design system

1.17.0 (2026-05-13)

Features

• add onRemove and disabled props to Chip component [BRAD-16149]

1.16.0 (2026-05-08)

Features

• add interactive type to Chip [BRAD-16395]
• pass extra props down in FlexWrapper and GridWrapper

1.15.1 (2026-04-08)

Fixes

• update overrideBrowserslist
• add period to list empty state without applied filters

1.15.0 (2026-03-30)

Features

• add border property to EmptyState and ListEmptyState
• add Table.EmptyState component

Fixes

• actually use a forwarded ref in ListEmptyState
• show subtext in ListEmptyState only if onClearFilters is passed

1.14.0 (2026-03-24)

Features

• add EmptyState component

1.13.1 (2026-03-17)

Fixes

• add no-gap-pad content modifier [BRAD-14670]

1.13.0 (2026-03-16)

Features

• add Table component

1.12.0 (2026-03-11)

Features

• add LabelCard component [BRAD-14631]

1.11.0 (2026-03-05)

Features

• add sx property to Accordion

Fixes

• use IconInternal in accordion to avoid unwanted classes

1.10.0 (2026-03-04)

Features

• add Label component [BRAD-14320]

1.9.3 (2026-02-26)

Fixes

• remove background on Pagination items

1.9.2 (2026-02-11)

Fixes

• prevent inherited line-height from affecting Badge text alignment

1.9.1 (2026-02-04)

Fixes

• change jd-green button color to @white

1.9.0 (2026-02-03)

Documentation

• add Slack link to CommentsBanner

Features

• add Pagination component

1.8.0 (2026-02-03)

Features

• add partnerLogo prop to Alert

1.7.1 (2026-01-12)

Fixes

• remove padding property from CommentsBanner component

1.7.0 (2025-12-18)

Features

• add Alert component
• add CommentsBanner component

1.6.1 (2025-11-27)

Documentation

• mention bradley’s WATCH_POLL environment variable

1.6.0 (2025-11-26)

Features

• add Card component

1.5.0 (2025-11-26)

Features

• add border, borderRadius, margin and padding style props

Fixes

• use !important for style props
• don’t limit fontSize values in Button and Typography
• output margin and padding helper classes in intuitive order

1.4.2 (2025-11-17)

Fixes

• make gap overrides work propertly in GridWrapper

Performance Improvements

• move media overrides into separate classes in style props

1.4.1 (2025-11-12)

Fixes

• don’t override Typography default color, let it be inherited
• don’t default to 0 column/row gap values in GridWrapper

1.4.0 (2025-11-11)

Features

• add Box component as a basic building block

Fixes

• use hover feature instead of screen width to style :hover/:active

1.3.2 (2025-11-05)

Fixes

• make sure Badge’s pseudo-elements stay hidden

1.3.1 (2025-10-20)

Fixes

• use CSS Modules to style Accordion, ArrowLink and Chip
• use CSS Modules to style Badge

1.3.0 (2025-10-13)

Features

• add link color to Icon component

1.2.0 (2025-10-02)

Features

• add optional color prop to Icon component

1.1.1 (2025-10-02)

Fixes

• make sure Button sets default value for type if as is absent

1.1.0 (2025-09-26)

Features

• allow customizing Button’s underlying element

1.0.0 (2025-09-26)

BREAKING CHANGES

define exports field in package.json

importing arbitrary modules that are not defined in exports is not possible anymore.

use CSS custom properties for theming

setting LESS variables for theming no longer works.

stop using mixins for vendor prefixes

mixins for vendor prefixes no longer exist

make sure button has properly working types

Button expects passing false as a value for color, minWidth and size to opt-out of a default value

Documentation

• describe usage in README.md
• add type arg to Button’s stories

Features

• publish esm instead of cjs
• allow customizing Button’s underlying element

Fixes

• specify sideEffects in package.json
• define exports field in package.json
• use CSS custom properties for theming
• emit source maps for js
• make sure button has properly working types

Performance Improvements

• stop using mixins for vendor prefixes