Nuxt

vael-ui/nuxt is a Nuxt module — add it once and every vael-ui component becomes usable in a template with no manual import at all, using Nuxt's own built-in component registration instead of unplugin-vue-components.

Setup

Register the module in your Nuxt config:

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['vael-ui/nuxt'],
})

That's it — write the tag, Nuxt resolves the import for you:

<template>
  <Button variant="primary">Save</Button>
</template>

exclude

Skip specific component names — useful if you want to register your own <Button> under that same tag instead:

export default defineNuxtConfig({
  modules: ['vael-ui/nuxt'],
  vaelUi: {
    exclude: ['Button'],
  },
})

VDOM only

This module always registers from the regular vael-ui build, never vael-ui/vapor — so there's no variant option here the way vael-ui/resolver has one. Vue 3.6 itself supports Vapor SSR hydration, but the stable Nuxt release has no Vapor configuration yet — it's landing behind specific upstream PRs, not yet in a general release. Once Nuxt's own Vapor support ships, a variant option can follow.

Using unplugin-vue-components instead

If your Nuxt setup already drives component auto-import through unplugin-vue-components for other libraries, use vael-ui/resolver instead — see the Auto Import guide.