Nuxt stories

Nuxt stories module - a kind of ultra light Storybook

• ✨  Release Notes

Features

• 👯‍♀️  Share the same configuration between the app and the stories
• 💆‍♂️  No configuration needed
• 🚀  Fast - no extra build step during development

Quick Setup

1. Add @rezo-zero/nuxt-stories dependency to your project

# Using pnpm
pnpm add -D @rezo-zero/nuxt-stories

# Using yarn
yarn add --dev @rezo-zero/nuxt-stories

# Using npm
npm install --save-dev @rezo-zero/nuxt-stories

2. Add @rezo-zero/nuxt-stories to the modules section of nuxt.config.ts

export default defineNuxtConfig({
  modules: [
    '@rezo-zero/nuxt-stories'
  ]
})

That's it! You can now use Nuxt stories in your Nuxt app ✨

Development

# Install dependencies
npm install

# Generate type stubs
npm run dev:prepare

# Develop with the playground
npm run dev

# Build the playground
npm run dev:build

# Run ESLint
npm run lint

# Run Vitest
npm run test
npm run test:watch

# Release new version
npm run release

Caveats

The app must use Nuxt layout.
Behind the scene, this module will use a layout stories (automatically injected) to display the stories.
At least, the app must have a default layout. That is how the layout can be switched by the module.