Read our updated documentation on https://ui.nuxt.com/.

🚨 Breaking Changes

In #2485, the expandable feature of the Table component has changed. You should use v-model:expand to achieve the functionality that was previously implemented using the #expand slot.

🚀 Features

• Form: add superstruct validation (#2357) (3cda6c6)
• Form: apply transformations (#2460) (ceecb60)
• Input/Textarea: nullify model modifier (#2309) (9dd7e61)
• InputMenu: allows to customize labels (#2295) (ddf67a0)
• Pagination: improve slot props (#2522) (c71fdc8)
• SelectMenu: allows to customize labels (#2266) (54e713d)
• Table: improve expanded row (#2485) (1acd01a)

🐛 Bug Fixes

• Accordion: improve items type (#2487) (25378df)
• Button: wrong to type (8ab4a14), closes #1253
• Divider: default type from app config (7846ca3), closes nuxt/ui#2398
• HorizontalNavigation/VerticalNavigation: handle badge in RTL mode (#2420) (4bf81be)
• InputMenu/SelectMenu: allow access nested object in option-attribute (#2465) (ff18061)
• InputMenu/SelectMenu: escape regexp before search (c68ba76), closes nuxt/ui#2308
• InputMenu/SelectMenu: prevent unnecessary updates when modelValue is unchanged (#2507) (1a94b55)
• module: missing types in ui config (#2467) (23971ef)
• Progress: handle carousel and carousel-inverse animations in RTL mode (#2400) (20fb46a)
• RadioGroup: rendering empty slots (#2456) (b6ed1c5)
• Table: checkbox not checked while using props by (#2401) (1b7e36c)
• Table: indeterminate checkbox with pagination (#2439) (070d2f8)
• Table: export TableRow and TableColumn types (c36964b), closes nuxt/ui#2373
• Table: handle dot nation with by prop (#2413) (b72d343)
• Tabs: allow aria-label on items (3cf19ea), closes nuxt/ui#1934

👋 New Contributors

• @nikneym made their first contribution in #2397
• @mateusbellei made their first contribution in #2487
• @hacknug made their first contribution in #2456
• @edersoares made their first contribution in #2266
• @offich made their first contribution in #2522
• @ersankarimi made their first contribution in #2507
• @cjboy76 made their first contribution in #2467

Full Changelog: v2.18.7...v2.19.0

🚀 Features

• Accordion/Breadcrumb/CommandPalette/ContextMenu/DropdownMenu/NavigationMenu/Tabs: add labelKey prop (acfc6ce)
• Button: handle avatar prop (a54c3e4)
• CommandPalette: handle loading field in items (49abad2)
• ContextMenu/DropdownMenu: handle checkbox items type (8ef6e71), closes #2144
• ContextMenu/DropdownMenu: handle loading field in items (b975235)
• Form: add superstruct validation (#2363) (5385944)
• Input/InputMenu/Select/SelectMenu: handle avatar prop (53a3796)
• InputMenu/RadioGroup/Select/SelectMenu: handle labelKey and use get to support dot notation (f6f9823)
• NavigationMenu: handle children on vertical orientation (#2384) (34bddd4)
• Table: implement component (#2364) (b54950e)

🐛 Bug Fixes

• AvatarGroup: wrong ring on big sizes (61b2323)
• Button: invalid hover on link variant (df2013c)
• Checkbox: indeterminate prop not working (f6631ff)
• components: rename select to onSelect on items (b39c4d1)
• css: font-sans already applied on (9e03da4)
• css: make @theme default (a2bad2e)
• Drawer/Modal/Slideover: no need for z-index since its isolated (bcfa4b7), closes nuxt/ui#2347
• Input/InputMenu/Select/SelectMenu: uniformize placeholder color (f59844b)
• InputMenu/SelectMenu: escape regexp before search (7c21dde)
• InputMenu/SelectMenu: improve displayed value (0f9ac87), closes nuxt/ui#2353
• InputMenu: emit focus event (#2386) (7802aac)
• module: stop using tailwind's shorthand arbitrary variable syntax (#2366) (dcce571)
• Slideover: set max height on top / bottom positions (a68016e), closes nuxt/ui#2388

New Contributors

• @tomykho made their first contribution in #2386

Full Changelog: v3.0.0-alpha.6...v3.0.0-alpha.7

✨ Highlights

Introduced in #2298 , Nuxt UI v3 now embraces a full design system for its components. It brings more breaking changes but will let you customize your entire app at once through CSS variables.

I'd recommend reading the pull request and the updated documentation on https://ui3.nuxt.dev/getting-started/theme#design-system.

🚀 Features

• Carousel: implement component (#2288) (68ee3f1)
• Form: add Standard Schema support (#2303) (0955c07)
• module: implement --ui-radius CSS variable (#2341) (057e86c)
• module: implement design system with CSS variables (#2298)
• module: set disableTransition option on @nuxtjs/color-mode (b82af02)

🐛 Bug Fixes

• Accordion: use text-left break-words instead of truncate on label (6c7c2f0)
• Alert: default variant to solid for consistency (3a7c5c2)
• Button: center text with block prop (3cf5535), closes nuxt/ui#2317

👋 New Contributors

• @sandros94 made their first contribution in #2341

Full Changelog: v3.0.0-alpha.5...v3.0.0-alpha.6

🚀 Enhancements

• forms: allow null as initial value (#2275) (474accb)

🐛 Bug Fixes

• Carousel: arrows & indicators are broken in RTL (#2251) (db5e5c4)
• Carousel: pages calculation (#2345) (5cf24fa)
• Dropdown/Popover: conflict in toggle for touch devices (#2272) (4ae9654)
• Link: allow title field (0aa3909), closes #1439
• Tooltip: hide when text prop & slot are empty (#2232) (5ed5c57)

👋 New Contributors

• @DanielQolami made their first contribution in #2272
• @Gerbuuun made their first contribution in #2275
• @abolix made their first contribution in #2232
• @asokawotulo made their first contribution in #2296
• @OrbisK made their first contribution in #2307
• @EdmundChaplin made their first contribution in #2345

Full Changelog: v2.18.6...v2.18.7

🚀 Features

• module: enable @nuxtjs/color-mode (9dcf903)
• module: override dark variant with class strategy (0f86b87)

🐛 Bug Fixes

• Button: props specified more than once (66a04ad)

Full Changelog: v3.0.0-alpha.4...v3.0.0-alpha.5

🚀 Features

• Drawer: handle direction + handle props (5f77aac)

🐛 Bug Fixes

• Accordion: missing min-w-0 on trigger (6c28597)
• build.config: disable mkdist addRelativeDeclarationExtensions option (f54f607)
• CommandPalette: missing min-w-0 on root (a61e765)
• Drawer: improve max-width on mobile (fac52fa)
• InputMenu: missing group on trailing (2c7c41b)
• templates: app config colors type (96c9246)
• Toast: improve focus styles (1f9abda)

Full Changelog: v3.0.0-alpha.3...v3.0.0-alpha.4

🐛 Bug Fixes

• components: accept partial config in ui prop (#2235) (eecf4f7)
• Modal/Slideover: bind transition class to TransitionChild for Vue 3.5 (#2227) (803c20a)
• SelectMenu: wrong placeholder color with multiple (#2218) (28ad5cf)
• Table: colspan with expand (#2217) (56118c4)
• Tabs: handle icon margin in RTL mode (#2233) (ea05414)
• useFormField: optional property access (#2226) (0a054a5)

New Contributors

• @alexfriesen made their first contribution in #2217
• @anthonyfranc made their first contribution in #2227
• @L422Y made their first contribution in #2234

Full Changelog: v2.18.5...v2.18.6

🚀 Features

• module: move colors options into theme.colors (2e95446)

Full Changelog: v3.0.0-alpha.2...v3.0.0-alpha.3

🚀 Features

• Button: loading-auto (#2198) (ed18e74)
• module: improve options (5076b8c)
• module: install @nuxt/fonts by default (8898a5d)

🐛 Bug Fixes

• Button: button link not showing disabled classes (#2189) (7c2adf2)
• Button: duplicate click handlers (#2213) (dd6bf56)

Full Changelog: v3.0.0-alpha.1...v3.0.0-alpha.2

🚀 Enhancements

• Form: add errors slot prop (#2188) (67c6a74)

🐛 Bug Fixes

• Button: button link not showing disabled classes (#2185) (e8ea84a)
• Carousel: remove trailing space in next button icon (#2088) (1282a5f)
• FormGroup: remove id when used with RadioGroup (#2152) (7aec42c)
• Input: avoid binding value when type is file (#2047) (82313e8)
• module: allow CSS variables in tailwind colors (#2014) (7f50c70)
• module: augment @nuxt/schema rather than nuxt/schema (#2171) (ead904f)
• module: consider user tailwind configPath for module as string (#2074) (e4ba4f7)
• Pagination: use links on prev and next button (#2179) (c850f85)
• Slideover: bind rounded class to panel (#2187) (bf32baa)
• Slideover: bind shadow class to panel (#2201) (d22526c)
• Table: checkbox can emit the @select event (#2072) (b1f691f)
• Table: select all rows reactivity issue (#2200) (68124de)
• Tabs: recalculate marker if items change (#2101) (82c4926)
• Textarea: resolve row count calculation errors caused by scrollbar (#2040) (8210936)

👋 New Contributors

• @kicaj made their first contribution in #2046
• @samuelbelo made their first contribution in #2084
• @Eazash made their first contribution in #2047
• @jonataw made their first contribution in #2101
• @vanngoh made their first contribution in #2072
• @Mini-ghost made their first contribution in #2040
• @emmanuel-ferdman made their first contribution in #2154
• @malik-jouda made their first contribution in #2187
• @husamMousa made their first contribution in #2200

Full Changelog: v2.18.4...v2.18.5