빠른 시작
앱을 생성하고 샌드박스에서 첫 Note를 저장합니다.
빠른 시작
Node.js 22.12+, npm 11.x, PHP 8.5.12+, Composer를 준비하세요. Console에서 개발자 계정을 만들고 시작합니다.
1. 도구 설치와 프로젝트 연결
터미널의 원하는 작업 위치에서 실행하세요.
npm install -g @nexia/cli@alpha
nexia setup --devtools
nexia create project my-project
cd my-project열린 브라우저에서 프로젝트 연결을 승인합니다. Console에서 이미 프로젝트를 만들었다면 create project 대신 빈 프로젝트 폴더에서 nexia connect <project-id>를 실행하세요. 프로젝트 ID가 포함된 명령은 Console의 개발 환경에서 복사할 수 있습니다.
2. 앱과 Note 생성
연결된 프로젝트 폴더에서 실행합니다. 각 명령의 질문을 완료하고 다음 명령으로 넘어가세요. my-app은 원하는 폴더명으로 바꿔도 됩니다. vendor에는 본인의 패키지 소유자 이름을 입력합니다.
nexia create app my-app
cd my-app
composer install --no-scripts
npm install
nexia make resource Note --label-ko 노트
nexia devdev는 켜 두세요. 새 앱은 두 번째 터미널의 같은 앱 폴더에서 nexia db migrate를 실행하고 완료된 뒤 엽니다. 이후 파일 저장만으로 migration을 적용하지 않으며, 준비되면 같은 명령을 다시 실행합니다.
dev가 앱 등록·샌드박스 준비·소스 반영을 진행합니다. 터미널을 켜 둔 채 위의 첫 migration을 별도 터미널에서 실행하세요.
3. 권한 설정과 저장 확인
- Console의 개발 환경에서 워크스페이스를 열고 설정 → 자격 증명 및 접근으로 이동합니다.
- 샌드박스 소유자는 준비가 끝난 개발 앱의 활성 권한을 자동으로 받습니다. 권한별 차이는 아래의 테스트 사용자로 확인합니다.
- CLI가 출력한 워크스페이스 URL을 엽니다. Console에서 열었다면 CLI의 로컬 주소를 연결합니다.
- 내 앱 → 운영 → 노트에서 새 노트를 저장합니다. 메뉴를 다르게 지정했다면 지정한 위치에서 엽니다.
- 새로고침 후 노트를 다시 열어 저장한 값이 유지되는지 확인합니다.
앱 실행 준비가 끝난 뒤 워크스페이스에서 권한을 설정하세요. 권한 목록에 Note가 없으면 앱 선언 반영 문제 해결을 확인하세요. 연결이나 실행이 실패하면 CLI 설치와 연결 오류 해결을 따르세요.
다른 사용자 권한으로 테스트
- 디렉터리 → 사용자에서 테스트 사용자를 준비합니다. 이메일 인증을 완료한 활성 사용자여야 합니다.
- 역할에서 앱의 개별 권한을 선택하고, 접근에서 테스트 사용자에게 역할과 적용 범위를 부여합니다. 권한이 없는 경우를 확인하려면 역할을 부여하지 않습니다.
- 사용자 상세의 이 사용자로 테스트를 선택합니다. 기존 개발 앱 연결은 유지되고, 화면과 API에는 선택한 사용자의 실제 권한이 적용됩니다.
- 조회·저장·차단 동작을 확인한 뒤 상단의 개발자로 복귀를 선택합니다. 권한을 바꾸고 다시 테스트할 수 있습니다.
이 기능은 개발 샌드박스에서만 제공됩니다. 전환 시 같은 샌드박스의 브라우저 탭도 새로고침되므로 작성 중인 내용을 먼저 저장하세요. 테스트 중 저장·삭제는 샌드박스 데이터에 반영됩니다. 테스트 중에는 초기 비밀번호·2단계 인증 설정 화면으로 이동하지 않으며, 계정의 실제 보안 설정은 변경되지 않습니다.
다음 작업
- 데이터 모델과 마이그레이션 — Note에 필드 추가.
- AI와 함께 로컬 개발 — 앱 폴더에서 코딩 에이전트와 작업.
- 로컬·Docker 개발 — 기존 프로젝트 참여, 개발 재개, Docker 사용.
- 개발 앱에 로컬 PostgreSQL 사용하기 — Nexia 제공 DB 대신 PC의 DB를 사용할 때 첫 실행 전에 설정.
- App 릴리스하기 — 완성한 앱을 심사에 제출.
개발을 마칠 때 Ctrl+C로 로컬 감시를 종료합니다. 원격 앱 실행과 샌드박스는 Console에서 관리하며, Ctrl+C로 저장한 데이터가 삭제되지는 않습니다.
CLI 명령과 옵션은 공개 CLI 문서에서도 확인할 수 있습니다.