reopt designreopt design
DocsExploreToolsPricingBuilder
Start
Overview
Start
Next.js 설치
Private install
Core Concepts
아키텍처
Composition Patterns
Accessibility
Keyboard Patterns
Styling
Theme System
Advanced Patterns
Build & Operate
Skills
AI Integration
CLI (opt surface add)
Dependency Graph
Tools
Canvas Catalog
Theme Builder
Form Builder
Templates
Templates
Releases
Release Notes
Oopt-ui
reopt designreopt design

A design system for the AI era

  • Docs
  • Pricing
  • Releases
  • GitHub
  • Terms of Service
  • Privacy Policy

© 2026 reopt-ai. All rights reserved.

Start
  1. Docs
  2. /
  3. Start
  4. /
  5. Private install

Private install

GitHub Packages 인증, manual install, Surface CLI 사용법을 별도로 정리

reopt design · Updated Jun 26, 2026

1. 토큰과 registry

내부 저장소/CI가 아닌 곳에서 설치할 때는 registry와 토큰 상태를 먼저 확인합니다.

ini
@reopt-ai:registry=https://npm.pkg.github.com
//npm.pkg.github.com/:_authToken=${GITHUB_TOKEN}
bash
export GITHUB_TOKEN=ghp_xxx
bun add @reopt-ai/opt-ui
bun add -d tailwindcss @tailwindcss/postcss postcss
npx @reopt-ai/opt-cli surface list

2. 패키지 설치

bash
bun add @reopt-ai/opt-ui

런타임은 @reopt-ai/opt-ui 를 import하고, 필요한 경우 optional peer dependency를 각 프로젝트에 추가합니다.

3. Surface 설치

bash
npx @reopt-ai/opt-cli surface add billing-page
  • npx @reopt-ai/opt-cli surface list 로 설치 가능한 Surface 목록을 확인합니다.

  • 복사된 Surface는 프로젝트 내부 코드로 취급하고 직접 수정합니다.

4. 문제 해결

  • 403 또는 404 가 나면 토큰 권한과 registry 설정을 먼저 다시 확인합니다.

  • Surface가 최신이 아니면 CLI 버전을 확인합니다. Surface registry는 CLI 패키지와 함께 배포됩니다.

PreviousNext.js 설치App Router 기준으로 opt-ui를 설치하고 theme/provider를 연결하는 방법Start
Go to Next.js 설치
Next아키텍처opt-ui Core/Shells/Surfaces와 opt-charts 분리, docs/registry 연결 방식을 설명합니다.Core Concepts