Development

This page summarizes the practical environment and workflow assumptions used during the alpha build-out.

Prerequisites

Node 20.11.x
npm 10.x
Windows packaging work benefits from Visual Studio Build Tools
GitHub access for releases, issues, and CI visibility

Install and Run

npm install
npm run typecheck
npm test
npm run dev

These steps reflect the verified alpha development flow after dependency alignment, native module rebuilds, and runtime fixes.

Windows note

If PowerShell execution policy blocks npm.ps1, use npm.cmd explicitly. The project also documented a stable Node 20 path for machines that default to newer incompatible Node versions.

Build and Release

The stable Windows alpha packaging path is:

npm run build:win

This produces the Windows x64 zip artifact currently used for alpha distribution. Release work in the repository also covers checksums, release notes, GitHub draft flow, beta tester tracking, and feedback collection.