how to contribute development workflow

Development workflow

The normal workflow is install, run the desktop app, change frontend or backend code, then run focused tests before the full validators.

Setup

npm install
npm run install:k6

package.json defines the npm scripts. scripts/install-k6.sh downloads the bundled k6 binary that the runtime looks for in src-tauri/src/k6/process/runtime.rs.

Running locally

npm run tauri dev

src-tauri/tauri.conf.json runs npm run install:k6 && npm run dev before launching the desktop shell. For frontend-only work, npm run dev starts Vite on port 5173.

Where to edit

Change type	Start here
Workflow UI	src/app/App.tsx, src/app/components/
Import or run state	src/features/import/, src/features/test/
API contract	src/lib/loadrift/api.ts, src/lib/loadrift/types.ts
Tauri commands	src-tauri/src/commands/
Postman parsing	src-tauri/src/importing/parser.rs
k6 execution	src-tauri/src/k6/process/runtime.rs
Reports	src-tauri/src/k6/report.rs
Packaging	src-tauri/tauri.conf.json, .github/workflows/release.yml, scripts/

Clean rebuilds

Clean rebuilds are for stale Rust/Tauri artifacts or native toolchain issues. The README documents rm -rf dist, cargo clean --manifest-path src-tauri/Cargo.toml, then npm run build or npm run tauri build.

For test commands, see Testing.