Build and test

App commands

Run these from the repository root.

npm install
npm run dev

Command	Purpose
`npm run dev`	Start Electron in development mode with renderer HMR.
`npm run typecheck`	Type-check main and renderer TypeScript projects.
`npm run test:unit`	Run Vitest unit tests.
`npm run test`	Run the full Vitest command configured by the project.
`npm run coverage`	Run tests with coverage.
`npm run build`	Type-check and build production bundles.
`npm run start`	Preview the built app with `electron-vite preview`.

npm run build:win
npm run build:mac
npm run build:linux

The Windows build is the primary packaged target. Other targets exist in the build configuration and may require platform-specific tooling.

From catalyst-plugin/:

./gradlew jar

The built JAR is written to catalyst-plugin/build/libs/CatalystAnalytics.jar.

Type-check

Run npm run typecheck after TypeScript changes.

Run unit tests

Run npm run test:unit for main-process and utility behavior.

Run the app

Use npm run dev to verify renderer flows and IPC behavior.

Package when needed

Use the platform build scripts before release testing.

Do not run hidden background windows or hidden servers during local verification. Start app and server processes plainly so failures are visible.