Chord Builder

Chord Builder is a local Electron desktop app for creating and organizing standard guitar and bass chord voicings across 24 frets.

Development

npm install
npm run dev

Validation and packaging

npm run lint
npm run typecheck
npm test
npm run build
npm run package

The production database is stored as chords.sqlite3 in Electron's userData directory. Chord data never leaves the device.

Continuous integration

• PR Validation (.github/workflows/pr-validation.yml) — runs lint (zero warnings allowed), typecheck, tests, and a full build on every pull request.
• Main Validation (.github/workflows/main-validation.yml) — runs the same checks on every push to main (i.e. whenever a PR is merged), keeping main always green.
• Artifact Production (.github/workflows/artifact-production.yml) — manually triggered (workflow_dispatch) with a required version input. It bumps package.json's version, tags the commit, builds installers for Linux (AppImage), Windows (NSIS), and macOS (dmg/zip) on their native runners, and publishes them as a GitHub Release. Installers are unsigned (no code-signing/notarization certificates are configured), so end users will see standard OS warnings (e.g. "unidentified developer" on macOS, SmartScreen on Windows) when installing.