# Output spec ## Deliverables | File | Format | Size | Notes | | --- | --- | --- | --- | | `screens/screen-01.png` ... | PNG | 1080 x 1920 (9:16) | One per entry (1 to 4). The art with the caption panel, the LOADING label and the bar drawn on locally | | `screens/profile-01.png` ... | PNG | 1080 x 1080 (1:1) | The plain art, no words, centred on the hero's face, for a profile picture (shown as a circle) | | `screens/sheet.png` | PNG | 12 px gap, 360 x 640 tiles | A set of 2 to 4 side by side. Only for a set | | `screens/manifest.json` | JSON | | Caption boxes, sizes, contrast and a fingerprint of each file. Read by the check | | `screens/guides/` | PNG | 1080 x 1920 | Optional, from `compose-screens.mjs --guides`: each screen with the zones and the profile crop drawn over it | | `art/` | PNG | 1088 x 1936 finals, 720 x 1280 drafts | The text-free art, kept so the words can be redrawn for free | | `screen.json` | JSON | | The plan: hero, look, style, captions, scenes, art paths, crop | Default settings: `openai/gpt-image-2/edit` with the photo as a reference (`openai/gpt-image-2` for a character with no picture); a draft at quality low, 720 x 1280; a final at quality medium, 1088 x 1936; `output_format` png. Captions in Helvetica Neue Bold (DejaVu Sans Bold on Linux) unless you pass a font file. ## Approximate cost (GPT Image 2 on fal, token-billed; read 2026-11-13) | Step | 1 screen | 4 screens | | --- | --- | --- | | Drafts at low (about $0.005 each, plus $0.01 for the photo) | about $0.02 | about $0.06 | | Finals at medium after drafts (about $0.10 each, plus $0.01 per reference) | about $0.12 | about $0.51 | | One re-roll of a draft, then its final | about $0.14 | about $0.15 | | A second-opinion final with nano-banana-pro (2K, flat) | $0.15 | $0.15 each | | Caption, bar, profile crop, checks | free | free | `build-requests.mjs --stage estimate` prints the total for the real plan; quote it and get one yes before the first paid call. fal returns no token count with the image, so check the fal dashboard after the run. ## Checklist Technical (`scripts/check-screens.mjs`, exit code 0): 1. `screen.json` has no `FILL:` left; 1 to 4 screens numbered in order; every name 1 to 3 words and at most 20 characters; every tagline at most 60 characters. 2. Every screen is a 1080 x 1920 PNG and has not changed since it was composed (its fingerprint matches the manifest). 3. Every screen was composed on the art the plan names now, from the final art (not an upscaled draft). 4. Every name, tagline, label and percent matches the plan letter for letter (the name in capitals when `style.case` is `upper`), the name in at most 2 lines and the tagline in at most 3. 5. The panel, every text line, the strip, the label, the percent and the bar sit inside the safe box: inside the 3:4 grid crop, out of the top 15 percent, the bottom 35 percent, the right 150 px and the left 90 px. Outside the old 1:1 square crop is a warning only. 6. The name is at least 84 px, the tagline at least 40 px, the label at least 30 px, and the set shares one name size. 7. Contrast is at least 4.5:1 for the caption on its panel and the label on its strip, and at least 3:1 for the bar fill on its strip. 8. Every profile crop is a 1080 x 1080 PNG, current, with the face centre within 40 percent of the side from its middle. 9. No caption, pose or scene uses a word about crime or violence. 10. A person hero has consent recorded (`consent.basis`, `consent.adult_confirmed`, `consent.confirmed`); a photo with a person is never filed as a pet, product or character. 11. Every screen's art is marked `art_text_free` (set by you after looking), and a set has a current `sheet.png`. By eye (open every screen at full size, then the guides and the profile crop): 12. **Recognisable:** the hero is clearly the pet, product, character or person in the photo: same markings, colours, shape, face. Compare side by side. 13. **No stray text in the art:** no letters, numbers, signs, licence plates, labels, logos, watermarks or game interface, other than lettering printed on the user's own product. 14. **Friendly:** no weapons, no violence, no crime, no police, no smoking or alcohol, no piles of money. The mood is cocky and funny. 15. **Not another game:** nothing in it reads as a particular game's title, logo, interface, character or scene. 16. **Clean art:** natural hands and paws, no extra limbs, no doubled shapes, no other people. 17. **The caption reads:** every word read letter by letter against the plan, and at phone size on the profile grid. 18. **Nothing important lost:** the hero is inside the grid crop and not hidden behind the panel; the open space really was open. 19. **One series (a set):** same look, outlines, light and caption style on every screen; the same hero; a different scene each time. 20. **People:** only an adult who agreed, exactly themselves, with a caption that is true and kind. 21. **Honest:** no invented results, awards or prices. ## If a check fails Caption, colour, side, bar and crop problems are free to fix: edit `screen.json` and recompose. Art problems: at most 3 attempts per screen, change one thing per attempt and say which (`references/prompt-patterns.md`, "Failure modes"), compare each attempt with the photo and with screen 1, then deliver the best and say plainly what still differs.