This 4.0.0-alpha.2 release focused mostly on stability and documentation.

The official v4 release should come next week after some more testing.

📚 Documentation

We've made significant improvements to the documentation in this release.

• Theme: rewritten and split into three sections - Design system, CSS variables and Component theming (#4939)
• Typography: moved to own section with headers, text formatting, lists, tables, images, embeds, and code blocks (#4742)
• MCP server: Model Context Protocol integration with tools, prompts and resources for AI assistants (#4878)

🚨 Breaking Changes

• Form: don't mutate the form's state if transformations are enabled (#4902)

Read the migration guide about this change: https://ui4.nuxt.com/docs/getting-started/migration/v4#changes-to-form-component

🚀 Features

• ContentNavigation: handle collapsible false with type multiple (c42c2ab)

🐛 Bug Fixes

• Banner: ensure actions slot renders (#4946) (5d6e1fc)
• CodeTree/Tree: improve accessibility (#4945) (117b4b3)
• components: dot notation type support for labelKey and valueKey (#4933) (11a0320)
• components: proxySlots reactivity (#4969) (3173bee)
• components: standardize naming for type interfaces (#4990) (788d2de)
• FileUpload: add missing button type (f33e43c), closes #4935
• Form: don't mutate the form's state if transformations are enabled (#4902) (99dbe81)
• Form: handling race condition on clear function (#4843) (2269b48)
• InputMenu/Select/SelectMenu: show falsy value when model value is falsy (#4882) (073dd14)
• locale: improve id name (#4890) (1b5d741)
• Marquee: handle RTL mode (#4887) (1846079)
• Progress: improve status-position when 0 (#4994) (0e1e44c)
• types: export missing tv types (#4971) (2bf273c)
• types: resolve ambient declaration error in icons type (#4991) (6ddf899)

🔥 Performances

• module: do not block setup by importing plugin (#4923) (695d9f7)

🌐 Locales

• locale: add Georgian language (#4973) (996478f)
• locale: add Swiss German language (#4962) (dcf17bb)

👋 New Contributors

• @reinacchi made their first contribution in #4890
• @USLTD made their first contribution in #4973
• @vitpetricak made their first contribution in #4991

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

🐛 Bug Fixes

• FileUpload: add missing button type (91f86d9), closes #4935
• Form: handling race condition on clear function (#4843) (0a8ead7)
• InputMenu/Select/SelectMenu: show falsy value when model value is falsy (#4882) (5b9d9d8)
• locale: improve id name (#4890) (e5cb55b)

Full Changelog: v3.3.3...v3.3.4

📚 Documentation

You can check out the new docs for v4 on https://ui4.nuxt.com while in alpha.

🚨 Breaking Changes

• components: rename nullify modifier to nullable and add optional (#4838)
• module: update compatibility to nuxt 4

Read the migration guide to v4.

🚀 Features

• Icon: allow passing a component instead of a name (#4766) (61b603f)

🐛 Bug Fixes

• AuthForm: use error from form field (#4738) (00dfb6b)
• BlogPost: ensure date slot renders (#4743) (4514880)
• ChangelogVersion/ChangelogVersions: handle RTL mode (#4777) (f91c408)
• ContentSearch/DashboardSearch: make ui.modal work (946c2ec)
• module: add @source on components (a16465f), closes #4773
• PageCard: improve keyboard accessibility (#4733) (3029568)
• ProseImg: ensure unique motion layout id for images (#4720) (9480a0b)
• unplugin: handle components overrides in subdirectories (#4781) (69ee75e)

New Contributors

• @cco3 made their first contribution in #4808
• @fabianmerino made their first contribution in #4826

Full Changelog: v4.0.0-alpha.0...v4.0.0-alpha.1

🚀 Features

• useFormField: export form errors injection key (#4808) (ec2bc0a)

🐛 Bug Fixes

• components: broken types for update:model-value event (#4853) (7133f50)
• Form: default slot types (#4758) (a32cc37)
• Form: update Form interface to accept RegExp (#4821) (0c2d390)
• InputMenu/Select/SelectMenu: show placeholder when model value is falsy (#4825) (90b5daf)
• InputMenu: prevent focus-outside event on content (77b6b9a)
• Link: ensure target _blank is flagged as external for Inertia (#4746) (520b277)
• Table: ensure colspan calc for loading and empty states (#4826) (bdcc8c4)

New Contributors

• @cco3 made their first contribution in #4808
• @fabianmerino made their first contribution in #4826

Full Changelog: v3.3.2...v3.3.3

🐛 Bug Fixes

• Meter: correct vertical alignment of progress bar (#4735) (875be4b)
• SelectMenu/InputMenu: ensure object compare with by prop (#4791) (44382cd)

New Contributors

• @DanielPagani made their first contribution in #4735

Full Changelog: v2.22.1...v2.22.2

📚 Documentation

You can check out the new docs for v4 on https://ui4.nuxt.com while in alpha.

🚨 Breaking Changes

• components: upgrade ai-sdk to v5 (#4698) (9545fdd)
• FieldGroup: rename from ButtonGroup (#4596) (8aa96d1)
• components: import @nuxt/ui-pro components (#4675) (f6ae153)
• Marquee: rename from PageMarquee (#4741) (0a4d9b4)
• PageAccordion: remove in favor of Accordion (#4734) (1c63aab)

Read the migration guide to v4.

Full Changelog: v3.3.2...v4.0.0-alpha.0

This release ensures the [email protected] dependency is installed. The 2.1.0 version is somehow broken at the moment: heroui-inc/tailwind-variants#259 / heroui-inc/tailwind-variants#258

Full Changelog: v3.3.1...v3.3.2

🚀 Features

• Form: support error RegExp in exposed methods (#4608) (b8b74a0)
• Tree: add item-wrapper slot (#4521) (411d937)
• useOverlay: return promise on open method (#4592) (58aac86)

🐛 Bug Fixes

• Drawer: improve closing animation with inset prop (#4676) (9da1527)
• FileUpload: handle wildcard in dropzone dataTypes (#4671) (729bed4)
• FileUpload: improve file removal a11y (#4607) (f90bba0)
• FileUpload: open dialog on keyup (#4629) (8e9265e)
• FileUpload: prevent default on keydown (#4633) (68d8a98)
• Input: incorrect rendering of type date / time on iOS (#4715) (93cc83c)
• InputMenu/Select/SelectMenu: add display value fallback when no items found (#4689) (34ca811)
• Select/InputMenu: handle focus via label inside a FormField (#4696) (55dbcd2)
• Tabs: add missing Badge import (#4594) (fbec29c)
• Toast: add type for progress ui prop (#4677) (a8af85c)
• Tooltip: render only if text or kbds are present (#4568) (5e39cbb)

New Contributors

• @calmyournerves made their first contribution in #4594
• @dev1-dylan made their first contribution in #4652
• @kazupon made their first contribution in #4674
• @cyrilf made their first contribution in #4597

Full Changelog: v3.3.0...v3.3.1

✨ Highlights

☁️ New FileUpload Component

Introducing a powerful new FileUpload component that makes file uploads effortless with built-in drag-and-drop and validation support (#4564).

Learn more: https://ui.nuxt.com/components/file-upload

🎨 Global Default Variants

Configure global defaults for color and size across all components to reduce boilerplate and ensure consistent styling (#4400).

export default defineNuxtConfig({
  modules: ['@nuxt/ui'],
  css: ['~/assets/css/main.css'],
  ui: {
    theme: {
      defaultVariants: {
        color: 'neutral',
        size: 'sm'
      }
    }
  }
})

Learn more: https://ui.nuxt.com/getting-started/installation/nuxt#themedefaultvariants

📊 Enhanced Table Component

Major improvements to the Table component bring enhanced functionality and better user experience:

• Footer support for column summaries (#4194)
• Context menu support (#4259)
• Colspan and rowspan support (#4460)
• Row hover events for better interactivity (#2435)
• Custom styles in table and column meta (#4513)

Learn more: https://ui.nuxt.com/components/table

🚀 Features

• CommandPalette: add footer slot (#4457) (63730d6)
• Drawer: add nested prop (e2695ee), closes #4320
• FileUpload: new component (#4564) (35dbe6c)
• Input/Textarea: add default-value prop (#4404) (fb9e7bb)
• InputMenu: emit remove-tag event (#4511) (6ca7c8b)
• InputTags: add max-length prop (b96a1cc), closes #4405
• Kbd: add color prop & soft variant (#4549) (f336600)
• module: add theme.defaultVariants option (#4400) (35f90b9)
• Popover: add reference prop (b00e07f)
• Table: add footer support to display column summary (#4194) (c355cac)
• Table: add style to table and column meta (#4513) (1db21d1)
• Table: add row hover event (f903ec3), closes #2435
• Table: add support for colspan and rowspan (#4460) (7ef1933)
• Table: add support for context menu (f62c5ec), closes #4259
• Tabs: add badge on items (#4553) (62ab016)
• Toast: progress bar with Progress component (ec569e4)
• Tooltip: add reference prop (69a7b95), closes #4430

🐛 Bug Fixes

• Button/Link: merge active-class / inactive-class with app config (#4446) (9debce7)
• Button: add active styles to behave like hover on mobile (df8f202), closes #991
• Carousel/Tree: add type to button elements for accessibility (#4493) (fc24e03)
• Carousel: add aria-current attribute to active dot (#4447) (1ba8a55)
• Carousel: improve accessibility (55e06e9), closes #4494
• Carousel: resolve plugins with page transitions (#4380) (3b67d54)
• ColorPicker: update color conversion logic (#4550) (6b6ec8c)
• CommandPalette: remove rtl:space-x-reverse from label (#4576) (4682ded)
• defineShortcuts: allow extra keys to be combined with shift (#4456) (772631c)
• defineShortcuts: always pass event to shotcut handler (#4516) (ef473c3)
• FormField: improve error type with boolean (a4d0ca7), closes #4496
• FormField: resolve minor accessibility and rendering issues (#4515) (c64c4cd)
• InputMenu/SelectMenu: filter null items in search (488707e)
• InputMenu/SelectMenu: improve display value without valueKey (4d4234d), closes #4528
• InputMenu/SelectMenu: only filter non-null fields (c92f908), closes #4509
• InputMenu: reset search term on mounted (cb160e6), closes #3993
• module: merge user's options when installing modules (78f92a2)
• NavigationMenu/Tabs: display badge when not undefined (b22891a)
• NavigationMenu/Tabs: proxy fallthrough attributes (836f748)
• RadioGroup: improve type safety for normalizeItem function (#4535) (bb99345)
• Table: add scope attribute to headers (#4417) (347694b)
• Table: handle reactive columns (#4412) (4ce6540)
• theme: colors autocomplete in app config (752e2b6)
• Toast: only show progress when open (1d052ec), closes #4464
• Tooltip: display separator only with text and kbds (#4570) (63476e5)
• useLocale: ensure inject defaults to en (df1abf1), closes #4579
• useLocale: prevent hydration error when switching locale (15c7991)
• useOverlay: don't use patch when passing props to open (#4497) (5ad7dab)
• useOverlay: improve props handling by mer...

🐛 Bug Fixes

• Badge/Button: support numeric zero as visible label (#4116) (2971a31)

Full Changelog: v2.22.0...v2.22.1