Changelog

7.2.0 (2026-09-08)

Features

• add badge variants

7.1.0 (2026-08-31)

Documentation

• split page structure guide into layout and page-composition sections
• lead component pages with a representative preview

Features

• add sortable column headers
• merge PageContent into Page and support full-bleed page content

7.0.0 (2026-08-25)

BREAKING CHANGES

redesign Pagination as a compact button-based pagination

PaginationLink and PaginationEllipsis are removed. PaginationPrevious and PaginationNext are now icon-only buttons (no href, no text label). Use PaginationLabel to show page position instead of numbered PaginationLink items.

Features

• redesign Pagination as a compact button-based pagination

6.0.0 (2026-08-21)

BREAKING CHANGES

require PageHeader and PageContent inside AppLayoutMain

AppLayoutMain no longer pads its content; render a PageHeader and a PageContent as its direct children and put the page’s content inside PageContent.

Documentation

• complete PageHeader sub-component JSDoc
• add PageHeader live preview

Features

• add PageHeader, PageContent, and TabsNav components
• require PageHeader and PageContent inside AppLayoutMain

Fixes

• keep TabsNav scroll position across unrelated re-renders

5.1.0 (2026-08-17)

Documentation

• add Filter composition trees and tighten prose

Features

• add Filter component

5.0.0 (2026-08-14)

BREAKING CHANGES

get rid of vaul dependency

Drawer now uses Base UI and the matching API consistent with other components.

update lucide-react to 1.28.0

Icon was renamed upstream: CircleEuroSignIcon -> CircleEuroIcon

align Drawer interactions

Drawer no longer renders a swipe handle unless showSwipeHandle is set.

remove DropdownMenuPortal export

DropdownMenuPortal is no longer exported from @falcon/ui-kit.

simplify Dialog composition

DialogOverlay and DialogPortal are no longer exported

remove RTL Toaster support

Toaster no longer accepts dir=“rtl”.

Documentation

• add prop descriptions to published package docs
• improve Accordion documentation
• improve Alert documentation
• improve AlertDialog documentation
• improve AppHeader documentation
• improve AppLayout documentation
• improve Badge documentation
• improve Breadcrumb documentation
• improve ButtonGroup documentation
• improve Button documentation
• improve Calendar documentation
• improve Card documentation
• improve Checkbox documentation
• improve Collapsible documentation
• improve Combobox documentation
• improve Dialog documentation
• improve Drawer documentation
• improve DropdownMenu documentation
• improve Empty documentation
• improve FalconProvider documentation
• improve Field documentation
• improve HoverCard documentation
• improve InputGroup documentation
• improve Input documentation
• improve Item documentation
• improve Label documentation
• improve NativeSelect documentation
• improve Pagination documentation
• improve Popover documentation
• improve RadioGroup documentation
• improve Select documentation
• improve Separator documentation
• improve Sheet documentation
• improve Sidebar documentation
• improve Spinner documentation
• improve Switch documentation
• improve Table documentation
• improve Tabs documentation
• improve Textarea documentation
• improve Toaster documentation
• improve Tooltip documentation
• improve Page structure documentation

Features

• align Drawer interactions
• remove DropdownMenuPortal export
• support indeterminate Checkbox state
• simplify Dialog composition

Fixes

• get rid of vaul dependency
• update lucide-react to 1.28.0
• inherit Button text color
• correct Combobox controls and layout
• preserve valid FieldError children
• use InputGroup radius tokens
• set Item list semantics
• remove RTL Toaster support
• forward ref from InputGroupAddon
• focus InputGroup textarea from addons
• expose PaginationEllipsis label
• only allow vertical resizing in Textarea
• preserve collapsed Sidebar accessible names
• leave google fonts imports in the final CSS

4.3.1 (2026-08-04)

Documentation

• render live previews in the Falcon font

4.3.0 (2026-07-31)

Features

• adopt Figtree as the sans font family

4.2.2 (2026-07-27)

Fixes

• suppress tooltips in expanded mode via Tooltip disabled

4.2.1 (2026-07-24)

Documentation

• make code samples contain entire modules with imports

Features

• refine sidebar and app header styling, move breadcrumb overflow scrolling into Breadcrumb

Fixes

• multiple tooltip bug

4.2.0 (2026-07-23)

Features

• set default icon stroke width to 2

4.1.0 (2026-07-21)

Features

• add 72px (section) to the spacing utility scale

4.0.0 (2026-07-16)

BREAKING CHANGES

switch SidebarMenuButton and SidebarMenuSubButton to render prop

SidebarMenuButton and SidebarMenuSubButton no longer accept asChild. Pass the element shell to render and the label as children: <SidebarMenuButton render={<a href="/x" />}>Label</SidebarMenuButton>.

Documentation

• improve documentation

Fixes

• switch SidebarMenuButton and SidebarMenuSubButton to render prop

3.1.1 (2026-07-14)

Documentation

• make style docs clearer

3.1.0 (2026-07-14)

Features

• add FalconProvider

3.0.2 (2026-07-13)

Fixes

• use neutral-200 for input border

3.0.1 (2026-07-13)

Documentation

• update documentation about styles

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