@vitral/nuxt

The Nuxt module for Vitral: the plugin from nuxt.config, auto-imported components and composables, the theme rendered on the server and the colour scheme in a cookie.
2,999 3
vue nuxt components nuxt-module ssr vitral
Install
npm install @vitral/nuxt
Latest Version:0.2.16
Vue:3
License:LGPL-3.0-or-later
Last Updated:Oct 3, 2026
Links: GitHub  ·  npm
Maintainer: stoshe

@vitral/nuxt

The Nuxt module for Vitral.

pnpm add @vitral/nuxt @vitral/vue

export default defineNuxtConfig({
    modules: ['@vitral/nuxt'],
    vitral: { preset: 'Prism', colorScheme: 'system' }
});

That is the whole setup. <VtButton>, <VtInputText>, useTheme() and the rest are auto-imported, the stylesheets go into the head of the page the server sends, and the colour scheme is kept in a cookie so the server renders the one the reader picked instead of flashing the wrong one.

Option What it does
preset A shipped preset by name ('Prism', 'Ink', 'Avalonia', 'Simple', 'Astra'), a module that default-exports one, or false
colorScheme 'light', 'dark' or 'system'
cookie Where the reader's choice is kept, so the server can read it. false forgets it
darkModeSelector Where the dark scheme applies: a class, an attribute, 'system' or false
locale 'en', 'ptBR', or a module that default-exports a locale
prefix The prefix on registered components. 'Vt' by default, '' for <Button>
components, composables Register them globally. Off means importing by hand
cssLayer, inputVariant, unstyled The same options the Vue plugin takes

Directives keep their plain names (v-tooltip, v-scrollbar), because they are registered on the application rather than auto-imported.

Documentation

LGPL-3.0-or-later. Part of the Vitral monorepo.

Related Packages

nuxt-request-context

Provide typed request-specific data to Nuxt before the initial render.

979 1
nuxt nuxt-module ssr request-context spa
nuxt-hydration-gate

Mark Nuxt app hydration with a DOM attribute for CSS, scripts, and end-to-end te...

211 0
nuxt nuxt-module ssr hydration playwright
@verbaly/nuxt

Nuxt integration for Verbaly: zero-config module with per-request locale negotia...

8,706 4
nuxt nuxt-module ssr hydration i18n verbaly
@trevor-okwirri/nuxt-query

TanStack Query for Nuxt with SSR hydration and auto-imported composables

686 0
nuxt nuxt-module ssr data-fetching tanstack-query vue-query
nuxt-graphql-middleware

Module to perform GraphQL requests as a server middleware.

62,192 70
nuxt nuxt-module ssr codegen graphql middleware typescript

Version History

Version Released License
0.2.16 LGPL-3.0-or-later
0.2.15 LGPL-3.0-or-later
0.2.14 LGPL-3.0-or-later
0.2.13 LGPL-3.0-or-later
0.2.12 LGPL-3.0-or-later