dangernoodle-io / TaipanMiner / 25141148676

90%

push

github

feat(flasher): browser-based factory firmware flasher (#265)

Adds webui/flasher — a Svelte + esptool-js + Web Serial app that flashes
factory firmware to TaipanMiner boards directly from a browser. Bundled
factory bins are populated from GitHub Releases at build time; site is
deployed via GitHub Pages.

Approach:
- gen-assets.mjs resolves the latest GitHub Release and downloads the
  per-board factory.bin into a gitignored public/firmware/ plus a
  manifest.json (tag, file, size, sha256). Loaded same-origin at
  runtime — no CORS proxy, no committed binaries, no client-side
  GitHub API call.
- gen-boards.mjs derives the dropdown from platformio.ini env sections
  and emits a per-board usbOtg flag (override map for future
  non-native-USB boards) used by esptool-js post-flash hard_reset.
- Fixtures mode (VITE_FLASHER_FIXTURES=1) writes 1KB stub bins for
  offline UI iteration; CI uses this for validation without network.

Deploy:
- .github/workflows/pages.yml builds + deploys on push to main
  (path-filtered to flasher/ui-kit) and on release:published. Each
  deploy bakes in the latest release at deploy time — soak happens on
  main pre-release.
- build.yml gains flasher typecheck + fixtures-mode build.
- One-time manual setup: enable Pages in repo settings (source =
  GitHub Actions) and configure the custom subdomain.

UX:
- Single Flash button — loads asset on click (instant, same-origin)
  then writes.
- Progress bar (extracted to ui-kit, shared with miner OTA).
- Web Serial disconnect detection; mid-flash unplug surfaces cleanly.
- 30s chip-sync timeout; BOOT-mode hint surfaced when sync fails;
  silent cancel on port-picker dismiss; translated error messages.
- Release/asset/size shown as soon as a board is picked.
- Disconnect button disabled during flash; chipInfo cleared on
  completion; success message mirrors error placement.
- Port released on beforeunload + pagehide.

Cross-app cleanup:
- Single canonical favicon + logo in ui-kit/assets/... (continued)

586 of 698 branches covered (83.95%)

Branch coverage included in aggregate %.

1360 of 1396 relevant lines covered (97.42%)

298004.69 hits per line