시작하기 | reopt design docs

시작하기

사설 GitHub Packages 설치 흐름과 Next.js/manual 셋업 가이드를 빠르게 연결합니다.

reopt design업데이트 2026년 6월 26일

1. 배포 모델

opt-ui 패키지는 공개 npm이 아니라 GitHub Packages 기반 사설 배포 패키지입니다. 소비자는 .npmrc 와 GITHUB_TOKEN을 설정한 뒤 설치해야 합니다.

ini

@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 설치는 각 패키지 문서의 시작하기 가이드를 따릅니다.

셋업은 Next.js App Router를 기본 경로로 두고, private registry/manual install 문서를 별도로 제공합니다.

Next.js 기준 빠른 시작은 아래 흐름입니다.

bash

bun add @reopt-ai/opt-ui
bun add -d tailwindcss @tailwindcss/postcss postcss

npx @reopt-ai/opt-cli surface add billing-page

Core/Shells는 @reopt-ai/opt-ui, 차트는 @reopt-ai/opt-charts import로 사용하고, Surface는 CLI로 소스를 복사해 프로젝트 내부에서 수정하는 방식을 기본으로 합니다.

유지보수자 배포는 직접 npm publish 나 bun run release* 를 사용하지 않고 /opt-ui-publish만 사용합니다.
Surface 또는 registry 입력이 바뀌면 CLI를 함께 배포해야 최신 Surface가 소비자에게 전달됩니다.
CI는 publish snapshot, registry.json, dist/docs/ freshness를 함께 검증합니다.