Fretboard Lab QA Checklist

Use this checklist for each release candidate before publishing downloads or website copy.

Run Metadata

  • Product version:
  • Build artifact:
  • OS and architecture:
  • License state tested:
  • Tester:
  • Date:

File And Path Handling

  • Short file: import or open a small chord/progression fixture if supported; the app loads it and exports diagrams without state loss.
  • Long file: import or paste a long progression with at least 200 chord symbols; search, filtering, and export remain responsive.
  • Chinese path: export PNG, PDF, Markdown, and JSON to a path such as 测试素材/指板图/Cmaj7.pdf; filenames and links remain valid.
  • Damaged file: open a malformed progression, JSON, or preset file; the app reports the line or field problem without crashing.
  • Huge file: try a progression or batch input near the documented size limit; the app rejects or processes it with visible progress.
  • Unsupported file: drop an audio file or random binary file into any import path; the app rejects it without showing audio-specific controls.

Audio/Sample-Rate Guard

  • Confirm Fretboard Lab does not require audio sampling rate settings for normal chord lookup and diagram export.
  • If an audio or MIDI preview path exists, verify 44.1 kHz and 48 kHz playback/export settings do not affect chord spelling or fingering results.
  • Importing files with audio-only metadata must not create a fake chord chart or silently discard errors.

Core Workflow

  • Enter common chord symbols: C, Cmaj7, Am7, Dm7b5, G7b9, F#dim, and slash chords.
  • Enter roman numeral progressions and confirm key changes update chord names correctly.
  • Browse generated fingerings by position, span, open strings, and difficulty.
  • Change tuning from standard to Drop D, DADGAD, Open G, Open D, and Half Step Down; diagrams update without stale fret positions.
  • Export selected diagrams only, then reopen the exported files in external viewers.
  • Bulk export a progression and confirm order, chord labels, tuning, and diagram count are stable.

License And Offline

  • No license: community chord lookup and basic export work; professional bulk export shows the correct locked state.
  • Valid online license: larger bulk export workflows and checkout license-key activation are available.
  • Activated license state: app launches with no network and preserves professional features.
  • Tampered or wrong-product license: app rejects the license without deleting local presets or exports.
  • No network: chord parsing, fingering generation, named tunings, and export all work.

Regression Signoff

  • No console panic or unhandled promise rejection during chord entry -> fingering browse -> tuning change -> export.
  • Release notes mention any remaining chord parser ambiguity or export limitation.
  • Screenshots and help copy match the current UI labels.