# Poolside radio ## What this builds A still, retro poolside scene with a radio you can start. The playlist is bundled and licensed in the repo. Tests check the scene by visual regression, and they assert that a fixture track actually starts (a playing flag and a local src). A hook fails if a stream host is contacted. The art is original. Read `spekkr.inputs.json` first. `title` is on the set. `track` is the starting index. `playlist` chooses the bundle. `water` and `sun` change the picture. Water may be frozen in checks. ## Out of scope - A live radio or a commercial stream. - Network in the checks. - A real pool booking. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Scene and track - The default scene, water frozen, sun on, matches the `scene` golden. - Play starts `playlist[track]` as a local file, sets a playing flag, and the `playing` frame matches. - A next-track control advances the index, modulo the list, and starts that file. Accept when: the goldens match, the src is local, and next-track advances as listed. ### R2. Files - A licence file lists every track. A fetch hook fails if a stream host is contacted. - One command compares the frames, starts the track, hooks, and writes sun-off as well. No network. Accept when: the hook stays quiet, licences are present, and all four frames match. ### R3. Inputs - The build reads `spekkr.inputs.json`. Settings label the UI, options turn features on or off, and a swap must be one of its choices. - A value outside a stated range, or a swap that is not one of its choices, is refused before the app starts its checks, with a message that names the key. Accept when: the default inputs render, an illegal swap is refused by name, and changing a visible setting (for example the title) shows up in a later check. ### R4. Checks and report - One command runs every acceptance check at the defaults and at the person's inputs, including golden frames where a requirement asks for them. - Checks do not need a network, a paid API, or physical hardware. Accept when: the command passes at the defaults, and a deliberately broken fixture or a wrong price fails it. ## Verification Visual regression covers the scene. A bundled playlist track actually starts (local src, playing flag). Next-track advances. A fetch hook fails if a live stream is contacted. Licences are shipped. No network. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to start the radio, how tracks are licensed, and how to run the checks.