boottent-design 0.1.230 → 0.1.232

package/README.md

@@ -10,6 +10,8 @@
   - [성능 권장 import](#성능-권장-import)
   - [모듈 import 경로](#모듈-import-경로)
 - [제작 및 배포](#제작-및-배포)
+  - [로컬 동시 개발 (watch + install)](#로컬-동시-개발-watch--install)
+  - [Storybook/Chromatic 운영](#storybookchromatic-운영)
 
 ## 소개
 
@@ -79,12 +81,8 @@ export function Sample() {
 ### 모듈 import 경로
 
 - `boottent-design/ui`
-- `boottent-design/components`
-- `boottent-design/provider`
-- `boottent-design/hooks`
+- `boottent-design/ui/*`
 - `boottent-design/tokens`
-- `boottent-design/utils`
-- `boottent-design/types`
 
 ### 참고
 
@@ -95,3 +93,79 @@ export function Sample() {
 
 - 김동성 (Boottent Frontend-Developer)
 - kody@boottent.com
+
+### 로컬 동시 개발 (watch + install)
+
+`boottent-design` 수정 사항을 npm 배포 없이 `boottent-frontend`에 반영하는 로컬 플로우입니다.
+
+1. `boottent-frontend`에서 로컬 의존성으로 전환
+
+```sh
+cd ../boottent-frontend
+yarn design:use-local
+```
+
+2. `boottent-design`에서 watch + install 동기화 실행
+
+```sh
+cd ../boottent-design
+yarn local:watch
+```
+
+내부 동작:
+- `build:lib:watch` + `build:styles:watch` 실행
+- `dist` 변경 감지 시 `../boottent-frontend`에서 `yarn install` 자동 실행
+
+3. `boottent-frontend` 개발 서버 실행
+
+```sh
+cd ../boottent-frontend
+yarn dev
+```
+
+4. 레지스트리 버전으로 복귀
+
+```sh
+cd ../boottent-frontend
+yarn design:use-registry
+```
+
+### Storybook/Chromatic 운영
+
+`boottent-design`은 Storybook 산출물을 Git에 커밋하지 않습니다.
+
+- `build-storybook` 산출물 경로: `.cache/storybook-static`
+- Git 비추적: `storybook-static`, `.cache`, `tsconfig.tsbuildinfo`
+- 목적: 빌드할 때마다 생성되는 해시 파일 변경 노이즈 제거
+
+로컬 확인:
+
+```sh
+yarn storybook
+```
+
+정적 빌드 확인:
+
+```sh
+yarn build-storybook
+```
+
+Chromatic 업로드(변경분만):
+
+```sh
+CHROMATIC_PROJECT_TOKEN=<your-token> yarn chromatic
+```
+
+CI는 `.github/workflows/chromatic.yml`에서 `onlyChanged: true`로 동작합니다.
+
+배포용 `yarn build`는 마지막에 `check:runtime-safety`를 실행해 `react-spinners` 같은 금지 런타임 코드가 `dist`에 다시 섞이지 않았는지 검증합니다.
+
+### npm 토큰 관리
+
+npm 인증 토큰은 레포 파일에 커밋하지 않고 환경변수로만 주입합니다.
+
+- 로컬: `export NPM_AUTH_TOKEN=<new-token>`
+- GitHub Actions: npm 인증이 필요한 워크플로가 생기면 Repository Secret `NPM_AUTH_TOKEN` 추가
+- Yarn 설정: `.yarnrc.yml`에서 `npmAuthToken: "${NPM_AUTH_TOKEN:-}"` 사용
+
+기존에 파일에 들어가 있던 토큰은 즉시 폐기(rotate/revoke) 후 새 토큰으로 교체해야 합니다.