Repository navigation
Open
Labels
Description
Nuxt UI v5 is a theming-led major. The full plan and the discussion live in #6610, this issue tracks what has landed.
We're working on the v5 branch. Prereleases will be published under the next npm tag and the docs will be available at https://ui5.nuxt.com, both starting with the first alpha. Until then, breaking changes are listed in the migration guide on the branch as they land.
Tasks
- Epic A: Design Tokens v2
- Resolve component colors through
--ui-accentand removetheme.colors: refactor(theme)!: resolve colors through--ui-accentand removetheme.colors#7024 - Move the colors from the app config to the
@nuxt/ui/colorsTailwind plugin, remove thecolors.tsruntime plugin: refactor(theme)!: move the colors from the app config to the@nuxt/ui/colorsplugin #7053 - One vocabulary for the semantic tokens and the accent roles,
@nuxt/ui/sourcesrenamed@nuxt/ui/tailwind: refactor(theme)!: one vocabulary for the semantic tokens and accent roles #7070 - New default colors: feat(theme)!: new default colors #7088
- Require two shades for a color in the
@nuxt/ui/colorsplugin: feat(theme): require two shades in the colors plugin #7114 - Add colors through the
@nuxt/ui/colorsplugin, typed in everycolorprop: feat(theme): add colors through@nuxt/ui/colorsplugin #7327 - Size controls through
--ui-control-*variables instead of compound variants: refactor(theme)!: size controls through tokens #7116 - One variable per color for its text,
--ui-<color>-text-default, that reaches every colored text: feat(theme): let one variable set the text of a color everywhere #7206 - Opt-in surface for floating layers,
bg-overlayand--ui-bg-overlay: feat(components): add an opt-in surface for floating layers #7252 -
--ui-gutter,--ui-focus-widthand--ui-disabled-opacityvariables, Container reads the gutter: feat(components)!: add gutter, focus width and disabled opacity variables #7280 - Name the sizing variables by subject and property,
--ui-container-widthand--ui-control-icon-size: refactor(theme)!: name sizing variables by subject and property #7283 - Control icons one step smaller at the same heights, the line of a control matches its icon,
--ui-control-text-<size>--leadingfor text that wraps: feat(components)!: match the line of a control to a smaller icon #7361
- Resolve component colors through
- Epic B: Prop & class renames
- Configure the filter input through a
filterprop and slot on every component that has one: feat(components)!: configure the filter input through afilterprop and slot #7207 - Key
Treeitems byvalueKey: feat(Tree)!: addvalueKeyprop and key items byvalue#6189 - Size the group labels of the menus and the tags from the control text: feat(components): size menu labels and tags from the control text #7344
- Render the menu filter as a field inset in the popup, lined up with the items: feat(components)!: render the menu filter as an inset field #7395
- Configure the filter input through a
- Epic C: Component restructures
- Migrate
Drawerto Reka UI's Drawer primitive and dropvaul-vue: feat(Drawer)!: replacevaul-vuewithreka-uiprimitives #6691 - Declare every theme class under a slot, single-element components included: refactor(theme)!: declare every class under a slot #6998
- Rename the
baseslot torooton layout containers: refactor(theme)!: rename thebaseslot torooton layout containers #7000 - Namespace
data-slotwith the component name: refactor(components)!: namespacedata-slotwith the component name #7003 - Hold the leading and trailing of fields in the flow of the box,
rootis the box andbasethe native element, newtagsslot: feat(components)!: hold the leading and trailing in the flow of the box #7192 - Migrate Table to TanStack Table v9, with a
featuresprop for pagination, grouping and faceting: feat(Table)!: migrate to TanStack Table v9 #7282
- Migrate
- Epic D: Defaults & behavior
- Remove the
fixedprop and the larger text of fields on mobile, opt in with--ui-control-text-step: feat(components)!: remove thefixedprop and the larger text of fields on mobile #7201 - Stack toasts by default,
expanddefaults tofalse: feat(Toaster)!: stack toasts by default #7281 - Tabs
pilldrops the color fill, the active tab is abg-defaultchip on the track: feat(Tabs)!: drop the color fill on thepillvariant #7328 -
ColorModeTabscomponent, icon only by default, with a newsquareprop on Tabs: feat(ColorModeTabs): new component #7331 - Tabs match the height of a Button of the same size, the
pilltrack reads--ui-tabs-track-padding: feat(Tabs): match the height of a button of the same size #7358, with a3pxtrack and the text of the size below: fix(Tabs)!: make the active tab less cramped #7392
- Remove the
- Epic E: Foundation & install contract
- Optional peer dependencies for
Editor,CarouselandTable: feat(components)!: move tiptap, embla and tanstack table to optional peer dependencies #6951 - Remove the
theme.transitionsoption: refactor(theme)!: remove thetheme.transitionsoption #7018 - Move
theme.defaultVariantstoui.defaultVariantsin the app config and<UTheme :props>: refactor(Theme)!: movetheme.defaultVariantsto the app config and<UTheme :props>#7028 - Move
theme.unstyledtoui.unstyledin the app config and<UTheme unstyled>: refactor(Theme)!: movetheme.unstyledto the app config and<UTheme unstyled>#7030 - Remove the
*Sizeslots: refactor(theme)!: remove the*Sizeslots #7031 - Prefix theme classes at runtime: refactor(theme)!: prefix classes at runtime #7035
- Spell out every theme class in the sources: refactor(theme): spell out every theme class #7036
- Move themes to the runtime and type their sources: refactor(theme): move themes to the runtime and type their sources #7040
- Ship static themes, no more per-project theme compilation: refactor(module): ship static themes #7037
- Ship the static CSS,
@nuxt/ui/tailwind+@nuxt/ui/basefor cascade layers: refactor(module): ship the static CSS #7043 - Read the app config through the theme context, the engine stops importing
#build/app.config: refactor(theme)!: read the app config through the theme context #7044 -
variantsandiconsprops on<UTheme>: feat(Theme): addvariantsandiconsprops #7046 - The app config and each
<UTheme>stack as override levels, the nearest winning: refactor(theme)!: stack the app config and each<UTheme>as override levels #7050 - Move
theme.prefixtotailwindPrefix, removingoptions.theme: refactor(module)!: movetheme.prefixtotailwindPrefix#7052 -
componentDetectionon by default, out ofexperimental: feat(module)!: detect the components in use by default #7058 - Detect newly used components while the Vite dev server runs: feat(vite): detect newly used components while the dev server runs #7059
- Move the Vue
uiconfig fromvite.config.tstoapp.use(ui, { ui }), the Vite plugin keeps the icons in a top-leveliconsoption: feat(vite)!: move the ui config to the Vue plugin #7271 - Remove the deprecated
inertiaoption of the Vite plugin: refactor(vite)!: remove theinertiaoption #7274 - Remove the deprecated
mdcoption: refactor(module)!: remove themdcoption #7275
- Optional peer dependencies for
- Epic F: Migration & rollout (migration guide, codemod)
- Epic G: Launch (landing, theme playground)
- Epic H: Own the styling engine
- Replace
tailwind-variantswith an in-tree variants engine: refactor(theme)!: replacetailwind-variantswith an in-tree variants engine #6964 - Call
tvwith the theme and its overrides, keyed by content: refactor(theme)!: calltvwith the theme and its overrides #6975 - Let
app.config.uislot classes win over theme variants: fix(theme)!: letapp.config.uislot classes win over theme variants #6976 - Resolve
app.config.uivariants after the theme variants,activeClassafter the theme: fix(theme): resolveapp.config.uivariants after the theme variants #6978 - Rename the
ui.tvmerge keys and drop deprecated gradient utilities: refactor(theme)!: rename theui.tvmerge keys and drop deprecated gradient utilities #7007 - Swap
tailwind-mergeforcn: refactor(theme)!: swaptailwind-mergeforcnbehind the merger seam #7011 - Write canonical Tailwind classes in the themes,
tailwindcsspeer^4.2: refactor(theme)!: write canonical Tailwind classes #7122
- Replace
Release
- Release
v5.0.0-alpha.0 - Deploy
ui5.nuxt.comfrom thev5branch - Release
v5.0.0 - Update templates to
v5 - Transfer
ui.nuxt.comfrom v4 to v5, move v4 docs toui4.nuxt.com - Publish release notes, blog post and tweet
Feedback
Feedback on the plan goes in #6610, keep this issue for progress. New feature requests and component requests aren't tied to v5 and can be opened as regular issues.
Reacted by Huseyn Guliyev, leonwillow, Manuchehr, Thiago Ferreira, lajxw, Mikasa33, FdwZ, Muhammad Mahmoud, Larra Su, Jakob Hofer and 21 more
Reacted by Ali Hardan, Max, ptsonev, Evan Schleret, Albert and Abdelrahman A Boker
Reacted by Huseyn Guliyev, Jesse Beck, Saul, leonwillow, Thiago Ferreira, Mikasa33, FdwZ, Muhammad Mahmoud, Jakob Hofer, elite-richmond and 20 more
Reacted by phatdang, fkwww27, Thiago Ferreira, Vachmara, Mikasa33, roiLeo, FdwZ, Mateusz Narowski, Muhammad Mahmoud, Larra Su and 15 more
Activity