Workbenches

The parts of this software that are drawn rather than written. A drawing is the one kind of output no test can check — code for an aeroplane whose wings rake the wrong way is exactly as correct as code for one whose wings do not — so each of these takes one piece out, holds it still, and says which file it came from.

Reporting something from a bench is most useful when it names the bench: “the travel scene looks wrong” is an afternoon of bisecting, and “the plane in Vehicle.tsx looks wrong” is ten minutes.

What is not benched, and why

A photobook and a postcard already have web previews built from the same millimetres the printer gets — they live inside a journal at /<user>/photobook and /<user>/postcards/<id>, because both need real photographs, a real trip and an owner. Only their geometry is here, which is the half that has no content in it. Locally, npm run photobook and npm run postcard drive the whole pipeline against the dry-run providers and write the files out.

Back to the documentation