피드로 돌아가기
Create and preview your own design system with shadcncraft create
Dev.toDev.to
Frontend

Preset Code 기반 Design System 시각적 검증 파이프라인 구축

Create and preview your own design system with shadcncraft create

shadcncraft2026년 4월 30일4intermediate

Context

기존 shadcn UI 설정 방식은 CLI 기반의 텍스트 설정에 의존하여 실제 복합 컴포넌트(Blocks)에 적용된 결과를 즉각적으로 확인하기 어려운 구조적 한계 존재. 디자인 시스템의 세부 설정 변경이 전체 사용자 경험에 미치는 영향을 파악하기 위해 반복적인 로컬 빌드와 설치 과정이 강제되는 비효율 발생.

Technical Solution

  • Preset Code라는 추상화된 설정 식별자를 도입하여 스타일, 테마, 폰트, 아이콘 라이브러리 등 디자인 시스템의 모든 변수를 단일 문자열로 캡슐화
  • npx shadcn@latest preset resolve 명령어를 통한 기존 프로젝트의 설정 상태를 Preset Code로 역추출하는 Resolver 로직 구현
  • 추출된 Preset Code를 shadcncraft create의 Live Customizer에 주입하여 Pro Blocks라는 고밀도 컴포넌트 환경에서 실시간 렌더링하는 Preview 레이어 구축
  • Preset Code의 호환성을 유지하면서 init(신규 생성) 및 apply(기존 적용) 명령어로 연결되는 단방향 설정 전파 워크플로우 설계
  • --only 플래그를 통한 부분 적용(Partial Application) 기능을 제공하여 테마나 폰트 등 특정 도메인 설정만 선택적으로 업데이트하는 제어 메커니즘 도입

1. 디자인 시스템 설정의 '상태(State)'를 고유 코드(Preset Code)로 직렬화하여 공유 및 이식성을 확보했는가?

2. 단순 컴포넌트 단위의 프리뷰가 아닌, 실제 서비스 수준의 복합 블록(Pro Blocks) 환경에서 시각적 검증 단계를 거쳤는가?

3. 전체 설정을 덮어쓰지 않고 필요한 부분만 업데이트할 수 있는 세밀한 적용(Granular Apply) 인터페이스를 제공하는가?

원문 읽기