Skip to Content
개발자로컬 개발 환경

로컬 개발 환경

저장소의 개발 컨테이너와 패키지 스크립트를 기준으로 시작하세요.

요구 환경

루트 매니페스트는 Node 22.17.1 이상인 22.x, pnpm 10.x를 요구하며 패키지 매니저는 10.32.0으로 고정합니다. 리비전을 바꿀 때는 매니페스트를 다시 확인하세요.

docker compose --profile dev up -d docker compose exec devcontainer bash

워크스페이스 설치는 컨테이너 초기화에서 처리합니다. 공용 빌드와 Prisma 마이그레이션은 호스트가 아닌 개발 컨테이너에서 실행하세요. 호스트의 네이티브 의존성 불일치를 전체 재설치로 복구하지 마세요.

워크스페이스 구성

client/*, server/*, packages/*가 pnpm 워크스페이스입니다. 공용 모듈은 packages/shared-*, Prisma는 packages/database에 있습니다. Gno 소스는 gno/contracts/r, gno/contracts/p에 있습니다.

로컬 접속점

서비스호스트 포트
Game36036
Docs 개발38083
Bridge3020
World3003
Communicate3030
Internal API3010
Admin API / client3040 / 5173
PostgreSQL / Redis5432 / 6379
Gnoland RPC / Gnoweb26657 / 8888

서비스 이름과 포트의 기준은 compose.yaml입니다. 로컬 접속점이며 공개 API 보장은 아닙니다. 검증은 각 패키지의 스크립트를 사용하고 설정 이름은 .env.example에서 확인하세요. 인증 정보는 공개하지 마세요.

Docs 실행

pnpm --filter docs dev pnpm --filter docs build

운영 빌드는 정적 페이지, 양쪽 언어의 검색 색인, 호환 경로를 생성합니다. 문서 유지보수를 확인하세요.