리소스
패키지 버전·호환성, 체인지로그 정책, 다운로드(아이콘·브랜드), Figma Sync 정책. 배포 자동화는 원격 연결(R-2) 시점에 활성화됩니다.
마지막 업데이트 2026-06-13
패키지 & 호환성#
세 산출물은 모두 같은 토큰 SSOT(tokens/)에서 생성되므로 같은 모노레포 커밋이
호환의 기준입니다 — 토큰을 고치면 두 플랫폼이 함께 재생성됩니다.
| 패키지 | 현재 | 소비 방법 |
|---|---|---|
토큰 (@wds/build-tokens) | SSOT | make tokens → tokens/dist/wds.css · wiz_tokens.dart 생성물 |
@wds/ui-web (React) | 0.2.0 | 워크스페이스 배럴 import (레지스트리 publish는 R-2) |
wiz_ui (Flutter) | 0.5.0 | git tag wiz_ui-v0.5.0 의존 |
소비 상세는 개발자 리소스를 참고하세요.
체인지로그#
전체 변경 이력은 체인지로그 페이지에서 확인할 수 있습니다 —
리포지토리 루트 CHANGELOG.md(플랫폼 서사 정본, Keep a Changelog 형식, AD-9)를 빌드타임에 렌더합니다.
- 커밋은 conventional commits(
feat/fix/docs/refactor/test/chore/perf/ci)를 따릅니다. - 버전 태깅과 자동 체인지로그 생성·패키지 publish는 GitLab 원격 연결(R-2) 시점에 시작합니다. Dart는 git tag, 웹은 GitLab Package Registry(npm)로 배포됩니다.
다운로드#
| 자산 | 위치 | 비고 |
|---|---|---|
| 아이콘 | icons/ (SVG 24px 그리드·1.8px 스트로크) | 추가는 SVG 1개 + make icons. 아이코노그래피 |
| 브랜드 심볼 | brand/ (symbol·symbol-dark·favicon·app-icon) | 브랜드 아이덴티티 |
| 토큰 시트 | tokens/dist/wds.css (codegen 산출물) | 앱 진입에서 1회 로드 |
번들 다운로드(아이콘 zip·일러스트·화면/문서 템플릿)와 Figma 라이브러리 파일 배포는 외부 자산 호스팅을 전제하므로 R-2 이후 제공됩니다.
Figma Sync 정책#
목표는 Design Token · Web Component · Flutter Component · Figma Library 간 정합입니다 (MASTER_PLAN §15 정본).
- Token JSON이 최상위 기준 — Figma Variables는 Token JSON을 기준으로 수동/반자동 반영
- Figma 컴포넌트 이름 = 코드 컴포넌트 이름(최대한 동일)
- 상태 어휘 통일 — Default / Hover / Focus / Active / Disabled (Web·Flutter·Figma 공통)
- 불일치 시 Token JSON + 실제 코드 구현을 정본으로 본다
네이밍 규약 — Figma 컴포넌트 경로는 컴포넌트 / 변형 / 크기 / 상태. Figma Library 변경은
코드 컴포넌트와 동시 리뷰하며, 제품군 영향도를 선검토합니다.
원격 연결(R-2) 이후#
다음은 GitLab 원격·CI 파이프라인이 활성화되면 제공됩니다:
- 자동 체인지로그 생성(conventional commits → 릴리스 노트)
@wds/ui-web레지스트리 설치(npm install) ·wiz_ui태그 배포 갱신- 아이콘·일러스트·템플릿 번들 다운로드
- Figma 라이브러리 파일 동기화 배포