🧪 Vitest 설정

configs/vitest-config 워크스페이스는 모노레포 내 여러 패키지와 앱에서 공통으로 사용할 수 있는 Vitest 테스트 설정(공유 config)을 제공합니다.

주요 목적

• 프로젝트 전반에 걸쳐 일관된 테스트 환경과 옵션을 유지합니다.
• 각 워크스페이스(앱/패키지)에서 이 설정을 확장하거나 그대로 사용할 수 있습니다.

주요 구성

• base.ts
  모든 패키지/앱에 공통 적용되는 기본 Vitest 옵션을 정의합니다.
• ui.ts
  React/Next.js 등 UI 라이브러리 및 앱 테스트에 특화된 옵션을 포함합니다.
• node.ts
  Node.js 환경에서 동작하는 패키지 테스트에 특화된 옵션을 포함합니다.

사용 방법

확장하기

각 워크스페이스의 vitest.config.ts에서 @repo/vitest-config/{config명}을 import 하여 사용할 수 있습니다.

import { mergeConfig } from "vite";
import { defineProject } from "vitest/config";
import uiTestConfig from "@repo/vitest-config/ui";
import viteConfig from "./vite.config";
 
export default mergeConfig(
  viteConfig,
  mergeConfig(
    uiTestConfig,
    defineProject({ test: { setupFiles: ["./src/tests/setup.ts"] } }),
  ),
);

테스트 커버리지 수집 설정

configs/vitest-config 워크스페이스는 Turbo를 활용해 여러 패키지의 커버리지 리포트를 자동으로 병합하고, 최종 리포트까지 생성할 수 있도록 다음과 같은 작업(tasks)을 제공합니다.

• collect-json-reports
  각 패키지의 커버리지 결과(coverage/raw/**)를 수집합니다.
• merge-json-reports
  수집된 커버리지 리포트들을 병합하여 coverage/merged/**에 저장합니다.
• report
  병합된 커버리지 데이터를 바탕으로 최종 커버리지 리포트(coverage/report/**)를 생성합니다.
• view-report
  최종 커버리지 리포트 생성 이후, 리포트를 확인할 수 있습니다.

이러한 작업들은 Turbo task로 정의되어 있어, 모노레포 전체의 테스트 커버리지를 손쉽게 집계하고 관리할 수 있습니다.

참고

• 실제 옵션 및 상세 설정은 configs/vitest-config/configs 디렉토리의 각 config 파일을 참고하세요.
• 새로운 공통 테스트 옵션이 필요하다면 이 워크스페이스에 추가하여 전체 프로젝트에 적용할 수 있습니다.