Storybook 완벽 가이드

← 메인으로 돌아가기

Storybook으로 컴포넌트를 문서화하고 개발 생산성을 극대화하세요.

📚 Storybook이란?

Storybook은 UI 컴포넌트를 독립적으로 개발하고 문서화하는 오픈소스 도구입니다. 컴포넌트를 격리된 환경에서 개발하고 테스트할 수 있습니다.

핵심 기능

  • • 컴포넌트 독립 개발
  • • 인터랙티브 문서화
  • • 시각적 테스트
  • • 디자인 시스템 구축
  • • 팀 협업 강화

주요 장점

  • • 빠른 개발 사이클
  • • 버그 조기 발견
  • • 재사용성 향상
  • • 일관된 UI/UX
  • • 자동 문서 생성

Storybook 기초

완료

Storybook 설정과 첫 Story 작성하기

설치 및 설정Story 작성법CSF 3.0
예제 보기 →

Controls & Args

완료

인터랙티브한 컨트롤로 컴포넌트 테스트하기

ArgTypesControls 활용동적 Props
예제 보기 →

MDX 문서화

완료

MDX를 활용한 고급 문서 작성

MDX 문법CanvasMeta 태그
예제 보기 →

Addon 활용

완료

Essentials와 커스텀 Addon 사용법

ActionsDocsViewport
예제 보기 →

자동 문서 생성

완료

TypeScript와 JSDoc으로 자동 문서화

TypeScript PropsJSDocautodocs
예제 보기 →

Design Tokens 연동

완료

Design System과 Storybook 통합

Token 시각화Theme ProviderCSS Variables
예제 보기 →

🎯 Storybook 핵심 개념

Story: 컴포넌트의 특정 상태를 표현하는 단위
Args: 컴포넌트에 전달되는 props 값
Controls: Args를 동적으로 조작하는 UI
Docs: 자동 생성되는 문서 페이지
Addons: 기능을 확장하는 플러그인

📦 CSF 3.0 형식

// Button.stories.tsx
import type { Meta, StoryObj } from '@storybook/react';
import { Button } from './Button';

const meta: Meta<typeof Button> = {
  title: 'Components/Button',
  component: Button,
  tags: ['autodocs'],
};

export default meta;
type Story = StoryObj<typeof Button>;

export const Primary: Story = {
  args: {
    variant: 'primary',
    children: 'Button',
  },
};

💡 학습 로드맵

1. 기초 → 고급: Storybook 설치부터 MDX 문서 작성까지 단계별로 학습

2. 실습 중심: 실제 컴포넌트를 만들면서 Storybook 활용법 체득

3. 자동화: TypeScript와 JSDoc으로 문서 자동 생성 구현

4. 통합: Design Tokens와 연동하여 완전한 Design System 구축