Studio v0.2.0
Studio v0.2.0 · Product manual

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 desktop

The 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:start

After 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 symptomNext action
node or pnpm is not foundPrepare the stated development environment, reopen the terminal and check versions; a packaged desktop build runs directly
First-time font or media preparation failsCorrect the reported download, path or permission problem, then rerun desktop
Source changed but the window still looks oldStop the old service explicitly, then rebuild/start; desktop:start launches the existing build

See Plugin SDK for extension packages and Installation for packaged applications.