mineracks/seedhammer-v1-companion
1
0
Fork 0
mirror of https://github.com/mineracks/seedhammer-v1-companion.git synced 2026-06-26 22:01:05 +10:00
Code Issues Actions Packages Projects Releases Wiki Activity
3696dd6b34
seedhammer-v1-companion/web/README.md
mineracks 3696dd6b34 Initial skeleton — Phase 1 scaffolding 
A browser-based companion for SeedHammer v1 hardware. Three coordinated
PWAs (composer, emulator, combined-sim) plus an optional Android wrapper,
inspired by Gangleri42's SeedHammer II fork but retargeted to v1's
Pi-Zero / WaveShare / MarkingWay hardware.

What's in this commit:

- LICENSE: Unlicense (matching upstream)
- README.md: project overview + status + roadmap
- CREDITS.md: upstream provenance + pinned baseline SHAs
- docs/architecture/: five authoritative design docs (lifted from
  the prep work in mineracks-infrastructure):
  * BASELINES.md — pinned SHAs, license audit, path-mapping table
  * v1-engrave-spec.md — MarkingWay USB-serial wire protocol audit
  * v1-buttons-and-ui.md — GPIO map, UI screen flow, keyboard map
  * sh1e-spec.md — composer-to-Pi envelope format spec
  * seedsigner-reuse.md — Pyodide strategy + jumbo (SeedSigner+) support
- Go package skeleton with doc.go contracts:
  backup, bezier, bspline, engrave, engrave/wire, engrave/wire/sh1e,
  font (+ comfortaa, poppins, constant), gui, input, internal/golden,
  platform/v1
- cmd/ entrypoints with stub main(): composer, emulator, combined-sim,
  seedsigner-sim
- web/ static-shell skeleton
- go.mod (module github.com/mineracks/seedhammer-v1-companion, Go 1.22)
- go build ./... + go vet ./... both clean

Next: lift universal packages (backup, font, bezier, bspline) from
upstream seedhammer/seedhammer at v1.3.0 verbatim.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-28 18:25:03 +10:00

735 B
Raw Blame History

web/

Static-site assets for each browser target.

Path What it ships
composer/ The plate composer PWA (uses cmd/composer/ WASM)
emulator/ The v1 emulator PWA (uses cmd/emulator/ WASM)
combined/ The three-pane combined sim (uses all three)
seedsigner-sim/ The Pyodide-hosted SeedSigner emulator
shared/ Common CSS/JS/assets used by multiple shells

Each subdirectory has its own index.html, app.js, app.css, manifest.webmanifest, sw.js, modelled on Gangleri42's PWA shells.

Build pipeline (TBD — likely Vite or a small make rule that wires go build -o app.wasm ./cmd/X and copies static files to dist/).

Status: skeleton only; shells lifted in Phase 1.