CMS Orbit 매뉴얼

설치와 온보딩

최종 수정: 2026년 7월 12일

설치와 온보딩

요구사항

  • PHP ^8.3
  • Laravel ^11.0 || ^12.0 || ^13.0
  • Inertia Laravel ^3.0

Core 설치

composer require cms-orbit/core:^4.0php artisan orbit:install

orbit:install이 처리하는 작업:

  • 설정/마이그레이션/스텁 게시
  • entities/·OrbitProvider 준비
  • Inertia/Vite 연결 (orbit:frontend-sync)
  • AI 가이드 배포 (orbit:ai)
  • Laravel Boost 자동 갱신

관리자 계정 생성

php artisan orbit:admin

프론트엔드 자산

npm installnpm run dev   # 또는 npm run build

Laravel Boost 연동

상황할 일
Boost 미설치orbit:ai만 실행 — Orbit 가이드 배포
Boost 최초 설정 전php artisan boost:install 1회 실행
Boost 이미 설정됨orbit:install / orbit:sync가 자동으로 boost:update 실행

호스트 설정 체크리스트

작업필수 여부설명
php artisan orbit:install필수 (최초 1회)설정, 마이그레이션, 스텁, 프론트 브리지
php artisan orbit:frontend-sync패키지 추가/제거 시Vite alias·Inertia 브리지 자동 생성
php artisan orbit:sync선택설정/스텁만 안전하게 재동기화
vite.config.* 수동 alias불필요orbit:frontend-sync가 관리
Entity를 OrbitProvider에 등록호스트 전용 Entity 사용 시패키지 Entity는 Provider가 자동 등록

SaaS 패키지 추가

composer require cms-orbit/saas:^4.0php artisan vendor:publish --tag=saas-config

번들 패키지 추가 예시

composer require cms-orbit/announcement:^4.0composer require cms-orbit/popup:^4.0composer require cms-orbit/sendgo:^4.0

각 패키지 설치 후 orbit:frontend-sync를 실행하세요.