storybook-gen

Storybook Generator

Point it at a React component. Get back complete Storybook stories with all the variants, controls, and edge cases. No more writing boilerplate stories by hand.

One command. Zero config. Just works.

Quick Start

npx ai-storybook ./src/components/Button.tsx

What It Does

• Analyzes component props and generates appropriate controls
• Creates stories for common states (default, disabled, loading, error)
• Handles complex prop types including objects and callbacks
• Generates proper TypeScript types for story args
• Includes realistic example data, not just placeholder text

Usage Examples

# Generate stories for a single component
npx ai-storybook ./src/components/Card.tsx

# Process entire components directory
npx ai-storybook ./src/components/ --recursive

# Output CSF3 format
npx ai-storybook ./src/Button.tsx --format csf3

# Include interaction tests
npx ai-storybook ./src/Modal.tsx --with-interactions

# Specify output directory
npx ai-storybook ./src/Input.tsx -o ./stories/

Best Practices

• Write good prop types first - Better TypeScript types mean better generated stories
• Include JSDoc comments - The AI uses your documentation to create meaningful descriptions
• Generate, then customize - Use this for the boilerplate, add your specific edge cases manually
• Keep components focused - Components with clear, single responsibilities generate cleaner stories

When to Use This

• Setting up Storybook for an existing codebase
• Adding a new component and need stories fast
• Documenting a component library for your team
• Creating a design system with consistent story patterns

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

• GitHub: https://github.com/LXGIC-Studios
• Twitter: https://x.com/lxgicstudios
• Substack: https://lxgicstudios.substack.com
• Website: https://lxgic.dev

Requirements

No install needed. Just run with npx. Node.js 18+ recommended.

npx ai-storybook --help

How It Works

The tool parses your React component to extract prop types, default values, and component structure. It then generates Storybook stories that exercise each prop combination, creating meaningful examples based on the prop names and types.

License

MIT. Free forever. Use it however you want.