@reco-inc/upbox-ui 0.1.1 → 0.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +8 -68
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -4,7 +4,11 @@ Upbox Design System - Vue 3 Component Library
4
4
 
5
5
  ## Storybook
6
6
 
7
- [Live Storybook](https://reco-inc.github.io/upbox-ui/)
7
+ 컴포넌트 데모와 props 문서는 Storybook 에서 확인한다.
8
+
9
+ ```bash
10
+ pnpm storybook # localhost:6006
11
+ ```
8
12
 
9
13
  ## Installation
10
14
 
@@ -132,79 +136,15 @@ Figma 팔레트 이름을 그대로 사용:
132
136
 
133
137
  Add `class="dark"` to the root element. All color tokens automatically invert.
134
138
 
135
- ## Development
136
-
137
- ```bash
138
- pnpm install # Install dependencies
139
- pnpm build # Build library
140
- pnpm dev # Watch mode
141
- pnpm typecheck # Type check
142
- pnpm storybook # Storybook dev server (localhost:6006)
143
- pnpm release # 릴리스 (아래 "배포 & 업데이트" 참고)
144
- ```
145
-
146
- ## 배포 & 업데이트
147
-
148
- npm public 레지스트리(`@reco-inc/upbox-ui`)로 배포한다. 저장소는 private 이고 빌드 산출물만 공개된다.
149
-
150
- ### 릴리스
151
-
152
- ```bash
153
- pnpm release # patch 0.1.0 -> 0.1.1
154
- pnpm release minor # minor 0.1.0 -> 0.2.0
155
- pnpm release major # major 0.1.0 -> 1.0.0
156
- pnpm release 0.4.2 # 특정 버전 지정
157
- ```
158
-
159
- 한 번 실행하면 아래를 순서대로 처리한다.
160
-
161
- 1. `pnpm build` 후 `dist/` 가 바뀌었으면 함께 커밋
162
- 2. `package.json` 버전 bump + 커밋 + `v0.1.1` 태그 생성
163
- 3. `git push --follow-tags`
164
- 4. `gh release create` 로 GitHub Release 발행
165
- 5. Release 발행에 반응해 `.github/workflows/publish-npm.yml` 이 npm 에 배포
166
-
167
- `main` 이 아니거나, 커밋 안 된 변경이 있거나, `origin/main` 과 어긋나면 중단한다.
168
- 소스만 커밋해 두면 `dist/` 재빌드·커밋은 릴리스 스크립트가 알아서 한다.
169
-
170
- ### 배포 인증
171
-
172
- CI 배포에는 저장소 secret `NPM_TOKEN` 이 필요하다. npmjs 에서 **granular access token**
173
- 을 발급해 등록한다 — `@reco-inc` **스코프** 선택 / Read and write / IP 제한은 비워둔다
174
- (GitHub Actions 러너 IP 가 고정이 아니다).
175
-
176
- ```bash
177
- gh secret set NPM_TOKEN --repo RECO-Inc/upbox-ui
178
- ```
179
-
180
- 로컬에서 직접 `npm publish` 하는 경우, 계정에 2FA 가 걸려 있으면 OTP 를 넘겨야 한다.
181
-
182
- ```bash
183
- npm publish --otp=123456
184
- ```
185
-
186
- > `.npmrc` 에 `@reco-inc:registry` 를 두지 않는다. scope registry 설정은
187
- > `publishConfig.registry` 보다 우선하므로 배포 대상이 조용히 바뀐다.
188
-
189
- ### Consumer 프로젝트 업데이트
139
+ ## 업데이트
190
140
 
191
141
  ```bash
192
142
  pnpm update @reco-inc/upbox-ui
193
143
  ```
194
144
 
195
- ### Stories 추가/수정 시
196
-
197
- - Stories 파일 수정 후 `pnpm build` → dist 의 `.stories.d.ts` 도 함께 커밋
198
- - `main` 브랜치 push 시 Storybook 이 GitHub Pages 에 자동 배포됨
199
-
200
- ### 새 컴포넌트 추가 시 체크리스트
145
+ ## Contributing
201
146
 
202
- 1. `src/components/<name>/` 컴포넌트 생성
203
- 2. `src/components/<name>/index.ts` 에서 export
204
- 3. `src/index.ts` 에 `export * from './components/<name>'` 추가
205
- 4. `src/global.ts` 에 GlobalComponents 타입 선언 추가
206
- 5. Stories 파일 작성
207
- 6. `pnpm build` 후 dist 포함하여 커밋
147
+ 개발·릴리스·배포 절차는 저장소의 `CONTRIBUTING.md` 참고한다.
208
148
 
209
149
  ## Tech Stack
210
150
 
package/package.json CHANGED
@@ -4,7 +4,7 @@
4
4
  "registry": "https://registry.npmjs.org",
5
5
  "access": "public"
6
6
  },
7
- "version": "0.1.1",
7
+ "version": "0.1.2",
8
8
  "type": "module",
9
9
  "description": "Upbox Design System - Vue 3 Component Library",
10
10
  "license": "UNLICENSED",