Source development
Source development — GalCraft Studio product manual.
Source development and CI use fixed Node.js 24.21.0 and pnpm 12.3.4 versions. The distributed npm application and independent plugin CLI support Node.js 22.12.0 or later; repository development uses the fixed environment above. Open PowerShell in the GalCraft repository root, alongside package.json and pnpm-lock.yaml, check the versions, install dependencies and start the complete desktop host:
git clone https://github.com/TianyuEric/GalCraft.git
cd GalCraft
node --version
pnpm --version
pnpm install --frozen-lockfile
pnpm --filter @galcraft/studio desktopThe final command builds Studio, the Players and the default engine, then opens a window. The first run needs network access for missing fonts and media tools; wait while the terminal is still building or downloading. To launch an existing build later:
pnpm --filter @galcraft/studio desktop:startAfter changing source, explicitly stop the old service with node apps/studio/service/cli.mjs stop, then run desktop again. Root pnpm dev starts the renderer's Vite service; use the desktop or local browser entry for authoring.
| Startup symptom | Next action |
|---|---|
node or pnpm is not found | Prepare the stated development environment, reopen the terminal and check versions; a packaged desktop build runs directly |
| First-time font or media preparation fails | Correct the reported download, path or permission problem, then rerun desktop |
| Source changed but the window still looks old | Stop the old service explicitly, then rebuild/start; desktop:start launches the existing build |
See Plugin SDK for extension packages and Installation for packaged applications.