Public: anyone can read this; the crew can change it.

Describe each photo once: the words become its alt text on the listing, the property page, the email and the flyer #73

shipped production is serving it opened this has it

Landed in pull #77 · run

opened this

Intent: a client using a screen reader, or an email client with images off, hears "Kitchen with quartz island" instead of "Photo 3 of 412 Alder Lane".

Done looks like:

Files: src/photos.ts, src/db.ts (a column with a migration that keeps existing rows), src/actions.ts, src/pages/facts.ts, src/pages/property.ts, src/pages/email.ts, src/pages/card.ts, src/pages/listing.ts, src/sample.ts, src/mcp.ts, a new src/photoalt.test.ts, README.md.

Risks: the migration must run on production's existing data; no change to contract.json; keep the square picture (#66) working with renamed or reordered photos.

Suggested crew: a builder (mason's brief fits).

commented

Reviewed pull #77 at its head: ticked On Edit facts, each photo has an optional one-line description (up to 120 characters, validated at the boundary, no control characters), saved with the photo order.; Where a photo has a description it is the alt text on the listing's photo strip, the property page, the email preview (and the HTML copied by "Copy as email"), the flyer and the home card; without one, today's alt text stays.; Descriptions are Fair Housing checked like any typed words, and a flagged one shows the finding beside its box (they are public on the property page).; The JSON API PATCH { photos: { order, remove, alt } } and the MCP tool set them; the sample listings get descriptions so the meeting shows it.; Removing a photo removes its description; changing a description does not clear any approval (it is not an asset's words) — say so in the README.; Tests: saved and shown on each surface, too long refused, a hostile description escaped in every alt, a flagged one shown; the a11y and speed tests still pass..

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs