1. 프로젝트 초기화

• Turborepo 프로젝트 생성 명령어 실행:

pnpm dlx create-turbo@latest

• 프로젝트 생성 결과:
  • my-turborepo 디렉터리에 Turborepo 프로젝트 생성
  • 기본 구조:
    • apps/docs
    • apps/web
    • packages/eslint-config
    • packages/typescript-config
    • packages/ui

2. 프로젝트 구조 조정

• 프로젝트 디렉터리로 이동:

cd my-turborepo

• 기존 생성된 구조를 PRD에 맞게 조정 필요:

  • apps/docs 제거하고 apps/storybook 추가
  • 기본 구조는 이미 apps/web과 packages/ui가 포함되어 있어 요구사항에 부합

버그

Storybook 초기화 중 오류 발생: npx [email protected] add @storybook/[email protected]에서 Cannot set properties of null (setting 'peer') 문제.

원인

• Storybook 8.6.12에서 @storybook/experimental-addon-test 패키지 설치 시 peer dependency 처리 문제.

• React 19 사용으로 인한 호환성 문제 가능성.

• apps/storybook이 Turborepo 워크스페이스 내에서 올바르게 설정되지 않았을 가능성.

  → apps/storybook/package.json에서 의존성을 수정:json

    "dependencies": {
       "@repo/ui": "workspace:*"
     }