diff options
| author | Craig Jennings <c@cjennings.net> | 2026-07-06 10:46:26 -0500 |
|---|---|---|
| committer | Craig Jennings <c@cjennings.net> | 2026-07-06 10:46:26 -0500 |
| commit | e3170c13c3599fe328c9ae33d39a7a80dc952ed9 (patch) | |
| tree | 4f420b36d4f6579b77f8ed8c64fdb40931427f93 /docs/specs/2026-07-06-radio-browser-lookup-spec.org | |
| parent | a2f7ef0d557af7435d40291b432ed126e5b8c493 (diff) | |
| download | dotemacs-e3170c13c3599fe328c9ae33d39a7a80dc952ed9.tar.gz dotemacs-e3170c13c3599fe328c9ae33d39a7a80dc952ed9.zip | |
docs(specs): add radio-browser lookup UI prototype
The prototype is a standalone HTML mockup of the four minibuffer screens for the radio-browser lookup: query, station list, multi-select, and created-and-playing. I drew it with real jazz-search data in the vertico and marginalia style. It shows the two candidate-annotation formats the design picks between. The spec's References section links to it.
This sets the convention for a spec's visual companion: docs/specs/<slug>.prototype.html, tracked alongside the spec.
Diffstat (limited to 'docs/specs/2026-07-06-radio-browser-lookup-spec.org')
| -rw-r--r-- | docs/specs/2026-07-06-radio-browser-lookup-spec.org | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/specs/2026-07-06-radio-browser-lookup-spec.org b/docs/specs/2026-07-06-radio-browser-lookup-spec.org index 9db7b92f..161e95a6 100644 --- a/docs/specs/2026-07-06-radio-browser-lookup-spec.org +++ b/docs/specs/2026-07-06-radio-browser-lookup-spec.org @@ -151,6 +151,10 @@ Add cj/music-radio-search (query -> search -> completing-read multi-select -> wr - url.el error handling is the likeliest rabbit hole. Keep the client tiny: one GET, parse, or a single user-error. Do not build a general HTTP layer. - Stream URL choice: a station can list several codec/bitrate variants under one name. v1 takes url_resolved as-is; picking among a station's variants is a vNext refinement, not a v1 problem. +* References / Appendix +- UI prototype (open in a browser): [[file:2026-07-06-radio-browser-lookup.prototype.html][2026-07-06-radio-browser-lookup.prototype.html]] — faithful vertico + marginalia mockup of the four minibuffer screens (query, station list, multi-select, created+playing) with real jazz-search data. Shows the two candidate-annotation variants the design chooses between (A: codec/bitrate/country/votes/plays; B: codec/bitrate/country/votes/tags). +- API shape verified live 2026-07-06 against de1.api.radio-browser.info (recorded in Problem / Context). + * Review and iteration history ** 2026-07-06 Mon @ 10:12:00 -0500 — Claude (for Craig) — author - What: resolved all four open decisions from Craig's answers and folded them into the design, config, rollout, and acceptance sections. |