@nuxt/ui

Nuxt UI

We're thrilled to introduce Nuxt UI v3, a significant upgrade to our UI library that delivers extensive improvements and robust new capabilities. This major update harnesses the combined strengths of Reka UI, Tailwind CSS v4, 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 dev branch for Nuxt UI v2.

Documentation

Visit https://ui3.nuxt.dev to explore the documentation.

Installation

pnpm add @nuxt/ui@next

yarn add @nuxt/ui@next

npm install @nuxt/ui@next

bun add @nuxt/ui@next

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" theme(static);
@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" theme(static);
@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.0-beta.4 (2025-03-12)

Features

• Form: global errors (#3482) (6e03d9c)
• Input/Textarea: allow null value in model (#3415) (cfe9b2e)
• useLocale: handle generic messages (#3100) (a9c8eb3)

Bug Fixes

• Button: missing import (21dbf01), closes nuxt/ui#3417
• Form: input blur validation on submit (#3504) (97c8098)
• vue: prevent calling useHead in colors (5ecd227)