@nuxt/ui

Nuxt UI

Nuxt UI harnesses the combined strengths of Reka UI, Tailwind CSS, and Tailwind Variants to offer developers an unparalleled set of tools for creating sophisticated, accessible, and highly performant user interfaces.

[!NOTE] You are on the v3 development branch, check out the v2 branch for Nuxt UI v2.

Documentation

Visit https://ui.nuxt.com to explore the documentation.

Installation

pnpm add @nuxt/ui

yarn add @nuxt/ui

npm install @nuxt/ui

bun add @nuxt/ui

Nuxt

• Add the Nuxt UI module in your nuxt.config.ts:

export default defineNuxtConfig({
  modules: ['@nuxt/ui']
})

• Import Tailwind CSS and Nuxt UI in your CSS:

@import "tailwindcss";
@import "@nuxt/ui";

Learn more in the installation guide.

Vue

• Add the Nuxt UI Vite plugin in your vite.config.ts:

import { defineConfig } from 'vite'
import vue from '@vitejs/plugin-vue'
import ui from '@nuxt/ui/vite'

export default defineConfig({
  plugins: [
    vue(),
    ui()
  ]
})

• Use the Nuxt UI Vue plugin in your main.ts:

import { createApp } from 'vue'
import { createRouter, createWebHistory } from 'vue-router'
import ui from '@nuxt/ui/vue-plugin'
import App from './App.vue'

const app = createApp(App)

const router = createRouter({
  routes: [],
  history: createWebHistory()
})

app.use(router)
app.use(ui)

app.mount('#app')

• Import Tailwind CSS and Nuxt UI in your CSS:

@import "tailwindcss";
@import "@nuxt/ui";

Learn more in the installation guide.

Credits

• nuxt/nuxt
• nuxt/icon
• nuxt/fonts
• nuxt-modules/color-mode
• unovue/reka-ui
• tailwindlabs/tailwindcss
• vueuse/vueuse

License

Licensed under the MIT license.

Changelog

3.0.1 (2025-03-21)

⚠ BREAKING CHANGES

• Form: drop explicit support for zod and valibot (#3617)

Features

• components: handle events in content prop (5dec0e1)
• locale: add Catalan language (#3550) (53cf1b4)
• locale: add Central Kurdish language (#3566) (b2034cc)
• locale: add Romanian language (#3587) (0229b0f)
• locale: add Urdu language (#3611) (126ba23)
• locale: add Uzbek language (#3548) (302e04b)

Bug Fixes

• Calendar: grey out days outside of displayed month (#3639) (a516866)
• ContextMenu/DropdownMenu: remove any from proxySlots (#3623) (764c41a)
• Modal/Slideover/Toast: prevent unnecessary close instantiation (f4c417d)
• module: handle tailwindcss import without theme(static) (#3630) (ecff9ab)
• module: mark functions used in exports as pure (#3604) (57efc78)
• RadioGroup: handle disabled on items (fe0bd83), closes nuxt/ui-pro#911
• Table: allow links to be opened when @select is used (#3580) (e80cc15)
• types: add missing export for Icon (#3568) (5e62493)
• unplugin: include @compodium/examples in auto-imports paths (#3585) (cc504b8)
• useLocale: unique symbol to use in @nuxt/ui-pro (#3603) (dec2730)
• vue: missing unhead context (#3589) (0897e9e)

Code Refactoring

• Form: drop explicit support for zod and valibot (#3617) (9a4bb34)