빠른 시작

개발자 콘솔에서 개발자 계정으로 가입하고 프로젝트를 만든 뒤 클라우드 샌드박스를 준비하세요. 샌드박스가 준비 완료되면 앱을 연결할 수 있습니다. 개발자 계정은 운영 워크스페이스의 계정·구독과 독립적입니다.

Nexia Core는 개발자에게 배포하지 않는 비공개 서버 소프트웨어입니다. Core 저장소 복제, 다운로드, 접근 권한 신청은 개발 절차에 포함되지 않습니다. 공개 CLI와 문서화된 SDK 계약을 사용해 내가 소유한 앱 폴더에서 작업합니다.

설치와 연결

Node.js 22 이상을 설치한 뒤 공개 CLI를 설치합니다.

npm install --global @nexia/cli@alpha
nexia login <project-id>12

<project-id>를 프로젝트 콘솔에 표시된 ID로 바꾸거나 콘솔의 완성된 명령을 복사하세요. CLI가 안내하는 승인 페이지에서 로그인한 뒤 대상 프로젝트와 연결 코드를 확인하고 승인합니다. 이 정적 앱 개발 경로에는 GitHub 토큰, 비공개 저장소 권한, PHP, Composer가 필요하지 않습니다.

앱 만들고 실행하기

nexia init my-app
nexia validate my-app
nexia dev my-app123

새 폴더 이름을 사용하세요. 초기화는 기존 폴더를 덮어쓰지 않습니다. 터미널을 켜 둔 채 nexia dev가 출력한 워크스페이스 주소를 여세요. 연결 화면이 나오면 CLI에 표시된 로컬 앱 주소를 연결합니다. 앱은 Nexia 작업 탭 안에서 열립니다.

my-app/public/index.html을 수정하고 저장한 뒤 작업 탭에서 바뀐 내용을 확인하세요. 필요하면 탭을 새로고침합니다. nexia.json은 앱과 화면을 선언합니다. 공개 파일에는 비밀번호나 토큰을 넣지 마세요. 로컬 서버는 보통 http://127.0.0.1:4310에서 내 컴퓨터에만 연결을 엽니다.

버전 제출하기

nexia validate my-app
nexia deploy my-app12

제출하면 변경할 수 없는 버전이 만들어지고 심사를 기다립니다. 프로젝트 콘솔에서 승인·반려와 의견을 확인하세요. 파일을 고쳐 다시 제출하려면 nexia.json의 버전을 올립니다. 이미 제출한 버전에 다른 내용을 덮어쓸 수 없습니다. 심사 승인만으로 고객 워크스페이스에 앱이 설치되지는 않습니다.

샌드박스와 연결 관리

개발자 계정당 활성 샌드박스는 1개입니다. 사용 기간은 7일이며, 연장하면 그 시점부터 7일로 갱신됩니다. 새 공간이 필요하면 버려도 되는 샌드박스를 삭제한 뒤 다시 만드세요. 삭제한 공간의 데이터는 제거되고 생성·연장·삭제 이력은 남습니다.

nexia logout으로 CLI 연결을 해제하고, Ctrl+C로 로컬 서버를 종료합니다.

현재 지원 범위

CLI 알파는 정적 브라우저 앱, 클라우드 업무 공간 안의 로컬 미리보기, 심사 제출을 지원합니다. 원격 서버 Function, 플랫폼 AI 호출·과금, 테넌트 데이터 접근은 제공하지 않습니다. PHP·React App SDK 패키지 계약은 별도의 연동 경로이며, SDK 문서 공개가 Core나 비공개 패키지 접근 권한을 의미하지 않습니다.

다음은 로컬 개발 또는 AI와 함께 개발입니다. 문제는 토큰과 개인정보를 제외한 재현 절차와 함께 개발자 지원에 알려주세요.

확인

nexia status로 원하는 프로젝트에 연결됐는지 확인하세요. 프로젝트 콘솔에서 개발 공간을 열고 작업 탭의 앱을 확인합니다.