Building from source

Requires Node.js 24 or newer and pnpm; the workspace uses workspace:* dependencies that npm cannot resolve.

git clone https://github.com/u8array/ZPLab.git
cd ZPLab
pnpm install

Web app

pnpm dev     # Vite dev server on http://localhost:5173
pnpm build   # static output in dist/

dist/ is entirely static; see Self-hosting for serving it. To host without building, every release ships the same output as *_web.zip.

Desktop app

The desktop app is a Tauri 2 shell around the same frontend. Besides the web toolchain it needs a stable Rust toolchain and the Tauri 2 prerequisites for your platform; follow that page rather than a copied package list, it changes with Tauri releases.

On Linux, two packages come on top of Tauri’s own list, for printing and for the keychain:

sudo apt-get install libcups2-dev libdbus-1-dev

pnpm tauri dev     # frontend plus native shell, with hot reload
pnpm tauri build   # installers in src-tauri/target/release/bundle/

tauri build runs pnpm build and packages the bundled MCP server first; both hooks live in src-tauri/tauri.conf.json.