Storybook Config

Storybook Configuration Skill

Overview

This skill generates production-ready Storybook 9 configurations with:

• Automatic framework detection (React, Vue, Svelte, Angular, Next.js, Solid, Lit)
• SOTA 2026 best practices
• Platform-specific optimizations (Tauri full support, Electron partial support)
• Optional visual generation integration
• Testing framework setup (Vitest + Playwright)

When to Use This Skill

This skill should be used when:

• Initializing Storybook 9 in a new project
• Updating existing Storybook configuration to SOTA standards
• Adding framework-specific optimizations
• Configuring platform-specific setups (Tauri, Electron)
• Setting up testing infrastructure (interaction, a11y, visual)

Quick Start

# Detect project framework and configuration
bash ${CLAUDE_PLUGIN_ROOT}/scripts/detect-framework.sh

# Use skill to generate configuration
# The skill will use AskUserQuestion for user preferences

Configuration Generation

Supported Frameworks

SOTA Patterns (2026)

1. Vitest Integration for Testing

// main.ts - Enable Vitest addon
addons: [
  '@storybook/addon-vitest', // Real browser testing
]

2. Accessibility Testing

// preview.ts - Configure axe-core
parameters: {
  a11y: {
    config: {
      rules: [
        { id: 'color-contrast', enabled: true },
        { id: 'button-name', enabled: true },
      ],
    },
  },
}

3. Autodocs with Tags

// main.ts - Auto-generate documentation
docs: {
  autodocs: 'tag', // Stories with 'autodocs' tag get automatic docs
}

// story.tsx
export default {
  tags: ['autodocs'], // Enable automatic documentation
}

4. Performance Optimization

// main.ts - Vite optimization
viteFinal: async (config) => {
  return {
    ...config,
    optimizeDeps: {
      include: ['@storybook/blocks'],
    },
  };
}

// Build optimization for CI
build: {
  test: {
    disabledAddons: ['@storybook/addon-docs'], // 2-4x faster
  },
}

5. Modern Controls

// preview.ts - Enhanced controls
controls: {
  matchers: {
    color: /(background|color)$/i,
    date: /Date$/i,
  },
  expanded: true, // Show all controls by default
}

Platform-Specific Configuration

Web Projects (Full Support)

Standard configuration with all features:

• Interaction tests
• Accessibility tests
• Visual regression tests
• Code coverage

Tauri Projects (Full Support)

Additional configuration:

// preview.ts - Tauri IPC mocks
decorators: [
  (Story) => {
    if (typeof window !== 'undefined' && !window.__TAURI__) {
      window.__TAURI__ = tauriMocks;
    }
    return Story();
  },
]

Best Practices:

• Run Storybook on separate port (6006) from Tauri dev server (5173)
• Mock window.__TAURI__ APIs in stories
• Keep UI components decoupled from IPC logic

Electron Projects (Partial Support)

Webpack overrides required:

// main.ts - Electron configuration
webpackFinal: async (config) => {
  config.target = 'web'; // Override electron-renderer
  config.externals = {}; // Clear Electron externals
  config.resolve.alias = {
    electron: false, // Mock electron module
  };
  return config;
}

// preview.ts - Electron preload API mocks
decorators: [
  (Story) => {
    if (typeof window !== 'undefined' && !window.api) {
      window.api = electronMocks;
    }
    return Story();
  },
]

Limitations:

• Only pure UI components fully testable
• Components with direct electron imports need refactoring
• IPC integration requires E2E tests separately

Design System Integration

Detected Design Systems

The skill detects and integrates with:

• Material UI (MUI) - Theme provider wrapper
• Ant Design - ConfigProvider wrapper
• shadcn/ui - Tailwind + Radix UI setup
• Chakra UI - ChakraProvider wrapper
• Mantine - MantineProvider wrapper

Example: MUI Integration

// preview.ts
import { ThemeProvider, createTheme } from '@mui/material/styles';
import CssBaseline from '@mui/material/CssBaseline';

const theme = createTheme({
  palette: {
    mode: 'light',
  },
});

export const decorators = [
  (Story) => (
    <ThemeProvider theme={theme}>
      <CssBaseline />
      <Story />
    </ThemeProvider>
  ),
];

Testing Configuration

Interaction Tests (Play Functions)

// Install dependencies
npm install --save-dev @testing-library/react @testing-library/user-event

// Enable addon
npx storybook@latest add @storybook/addon-vitest

Accessibility Tests

// Install addon
npx storybook@latest add @storybook/addon-a11y

// Configure in preview.ts
parameters: {
  a11y: {
    element: '#storybook-root',
    config: {
      rules: [
        { id: 'color-contrast', enabled: true },
      ],
    },
  },
}

Coverage Reports

// Install V8 coverage
npm install --save-dev @vitest/coverage-v8

// Run with coverage
npm run storybook:coverage

Configuration Templates

React with TypeScript (SOTA)

// .storybook/main.ts
import type { StorybookConfig } from '@storybook/react-vite';

const config: StorybookConfig = {
  stories: ['../src/**/*.mdx', '../src/**/*.stories.@(js|jsx|mjs|ts|tsx)'],
  addons: [
    '@storybook/addon-essentials',
    '@storybook/addon-vitest',
    '@storybook/addon-a11y',
    '@storybook/addon-links',
  ],
  framework: {
    name: '@storybook/react-vite',
    options: {
      strictMode: true,
    },
  },
  docs: {
    autodocs: 'tag',
  },
  viteFinal: async (config) => {
    return {
      ...config,
      optimizeDeps: {
        include: ['@storybook/blocks'],
      },
    };
  },
};

export default config;

// .storybook/preview.ts
import type { Preview } from '@storybook/react-vite';
import '../src/index.css'; // Global styles

const preview: Preview = {
  parameters: {
    actions: { argTypesRegex: '^on[A-Z].*' },
    controls: {
      matchers: {
        color: /(background|color)$/i,
        date: /Date$/i,
      },
      expanded: true,
    },
    layout: 'centered',
    a11y: {
      config: {
        rules: [
          { id: 'color-contrast', enabled: true },
        ],
      },
    },
    backgrounds: {
      default: 'light',
      values: [
        { name: 'light', value: '#ffffff' },
        { name: 'dark', value: '#1a1a1a' },
      ],
    },
  },
  globalTypes: {
    theme: {
      description: 'Global theme for components',
      defaultValue: 'light',
      toolbar: {
        title: 'Theme',
        icon: 'circlehollow',
        items: ['light', 'dark'],
        dynamicTitle: true,
      },
    },
  },
};

export default preview;

Quality Checklist

Before completing configuration:

• Framework detected correctly
• Correct Storybook 9 packages installed
• Addons configured based on user preferences
• Theme/design system integrated (if applicable)
• Platform-specific setup complete (Tauri/Electron)
• Example stories generated
• package.json scripts added
• README created with setup instructions
• Tests run successfully

Best Practices

Do's

• Use Vite for faster builds (when possible)
• Enable autodocs with tags
• Configure a11y testing by default
• Optimize Vite dependencies
• Use V8 coverage (faster than Istanbul)
• Provide platform-specific guidance

Don'ts

• Don't use Webpack unless required (Angular, legacy projects)
• Don't skip accessibility configuration
• Don't forget to add example stories
• Don't configure features user didn't select
• Don't assume all components work in Electron (document limitations)

Integration with Other Skills

• story-generation: Use configuration to generate framework-specific stories
• visual-design: Use detected design system for visual generation
• platform-support: Apply platform-specific patterns (Tauri/Electron)
• testing-suite: Configure test infrastructure based on user selections