@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.
- package/README.md +8 -68
- 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
|
-
|
|
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
|
-
##
|
|
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
|
-
|
|
196
|
-
|
|
197
|
-
- Stories 파일 수정 후 `pnpm build` → dist 의 `.stories.d.ts` 도 함께 커밋
|
|
198
|
-
- `main` 브랜치 push 시 Storybook 이 GitHub Pages 에 자동 배포됨
|
|
199
|
-
|
|
200
|
-
### 새 컴포넌트 추가 시 체크리스트
|
|
145
|
+
## Contributing
|
|
201
146
|
|
|
202
|
-
|
|
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
|
|