# Retro desktop ## What this builds A desktop in a browser tab: a wallpaper, icons, a menu, overlapping windows, and a couple of built-in apps (a notes pad and a tiny paint). It can be used as a playground or a portfolio shell. The look is nostalgic but original — it is not a copy of a commercial operating system, and it does not use that system's marks. Tests cover windowing, icons, and the two apps, plus a golden desktop shot. Read `spekkr.inputs.json` first. `title` and `user_name` appear in the chrome. `skin` chooses the look. `login` and `clock` change the first screen and the menu bar. The clock is injectable. ## Out of scope - A real operating system, or a clone of a trademarked desktop. - Network, accounts, or a guest file system beyond a session. - Running third-party binaries. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Windowing and icons - A double-activate (or a documented single click) on an icon opens that app in a window. Two windows can be open at once; the last clicked is on top. - A window can be moved, resized within min sizes in `design.md`, closed, and (if a control exists) minimised to a bar. - The icon positions of the default desktop are in `fixtures/desktop-icons.json`. Accept when: opening notes then paint produces two windows, paint is on top, and a move/resize/close script matches the fixture end state. ### R2. The two apps - Notes: typing a fixture string and then reading the notes file (or the in-memory buffer) returns that string. A save and a reload, in-session, keeps it. - Paint: a scripted stroke leaves the pixel at a listed coordinate within 8 levels of the chosen colour. A clear returns the paper colour. - Neither app requires a network. Accept when: the notes string round-trips, and the paint pixel and clear checks pass. ### R3. Frames and files - Goldens: the empty desktop, two windows, notes with the fixture string, and paint after the stroke. Time, if shown, is the injected 14:00. - One command runs windowing, apps, and writes the frames. No network. Accept when: the command passes for every skin, and the frames match (skins have sibling goldens or a documented chrome-only mask). ### R4. 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. ## Verification Windowing, icons, and two built-in apps (notes and paint) have behavior tests, including a notes round-trip and a paint pixel check. A golden desktop shot is taken with an injected clock. The skin is original and does not use a commercial OS mark. 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 open an app, how to add an icon, and how to run the checks.