시작하기
사설 GitHub Packages 설치 흐름과 Next.js/manual 셋업 가이드를 빠르게 연결합니다.
reopt designUpdated
1. 배포 모델
opt-ui 패키지는 공개 npm이 아니라 GitHub Packages 기반 사설 배포
패키지입니다. 소비자는 .npmrc 와 GITHUB_TOKEN을
설정한 뒤 설치해야 합니다.
@reopt-ai:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}@reopt-ai/opt-ui,@reopt-ai/opt-cli,@reopt-ai/opt-ui-primitives,@reopt-ai/opt-charts가 사설 배포 대상입니다.Surface 템플릿은
@reopt-ai/opt-cli의surface서브커맨드가 공식 배포 채널입니다.opt-datagrid,opt-editor설치는 각 패키지 문서의 시작하기 가이드를 따릅니다.
2. 가이드 선택
셋업은 Next.js App Router를 기본 경로로 두고, private registry/manual install 문서를 별도로 제공합니다.
3. 빠른 시작
Next.js 기준 빠른 시작은 아래 흐름입니다.
bun add @reopt-ai/opt-ui
bun add -d tailwindcss @tailwindcss/postcss postcss
npx @reopt-ai/opt-cli surface add billing-pageCore/Shells는 @reopt-ai/opt-ui, 차트는
@reopt-ai/opt-charts import로 사용하고, Surface는 CLI로 소스를
복사해 프로젝트 내부에서 수정하는 방식을 기본으로 합니다.
4. 유지보수자 메모
유지보수자 배포는 직접
npm publish나bun run release*를 사용하지 않고/opt-ui-publish만 사용합니다.Surface 또는 registry 입력이 바뀌면 CLI를 함께 배포해야 최신 Surface가 소비자에게 전달됩니다.
CI는 publish snapshot,
registry.json,dist/docs/freshness를 함께 검증합니다.