# Art QR ## What this builds A designer for scannable codes that still look like a poster or a mark. A URL goes in; a picture comes out. Every fixture design must decode back to the input URL with a standard decoder. A golden poster is checked. The marks and the layouts are original. This is not a generator of confusing or malicious look-alike addresses; the payload is exactly the URL the person entered. Read `spekkr.inputs.json` first. `title` is on the poster around the code. `url` is the payload. `style` chooses a layout. `logo` and `quiet` change the mark and the margin. ## Out of scope - Encoding something other than a URL in this version. - A live shortener or a tracking redirect in the checks. - A claim of artistic copyright over the QR standard itself. ## Requirements Each requirement has an id. Checks name the id they cover. ### R1. Decode - Each fixture in `fixtures/art-qr.json` (url, style, logo on or off, quiet on or off) renders an image that a standard decoder reads back as the exact URL, including scheme and case. - A deliberately broken fixture, with the logo covering too much, must fail the decode, so the test's decoder is known to work both ways. - The payload is the entered URL, not a shortened or rewritten address. Accept when: every good fixture decodes exactly, and the broken fixture fails to decode. ### R2. Frames and files - Goldens: a plain code, a poster with title, a logo-centre mark, and a tight quiet-off attempt that still decodes if the fixture says it should. - One command renders the fixtures, runs the decoder, and writes the frames. No network. Accept when: the command passes, and the frames match the goldens. ### 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 Every fixture design decodes back to the exact input URL with a standard decoder. A broken, over-covered fixture fails, proving the decoder. A golden poster render is checked. No network and no URL rewriting. ## Definition of done - Every acceptance check above runs from one command, and all pass at the person's inputs. - A README says how to make a poster, how to run the decoder checks, and how large a logo may be.