Installation

Get started with Nuxt UI in your project.

Install Nuxt UI

npx nuxi@latest module add ui

This installs:

  • @nuxt/ui
  • Tailwind CSS
  • Headless UI
  • Icon dependencies

Manual Installation

npm install @nuxt/ui
// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxt/ui']
})

Configuration

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@nuxt/ui'],
  ui: {
    global: true,
    icons: ['heroicons', 'mdi']
  }
})

Verify Installation

Create a test component:

<template>
  <UButton>Hello Nuxt UI!</UButton>
</template>

That's it! You're ready to use Nuxt UI components.

Nuxt UI
Welcome to the Nuxt UI section! Learn how to build beautiful, accessible user interfaces quickly.
Theming
Customize Nuxt UI to match your brand.
Files
Editor
Initializing WebContainer
Mounting files
Installing dependencies
Starting Nuxt server
Waiting for Nuxt to ready
Terminal