Photo
Chronological archiving, immutable originals, open sidecars — the media norms behind Reveal.
The norm of the archive. Photographs follow the same law as text —
file over app — with three rules that keep a lifetime of images sovereign
and machine-navigable.
Chronological archiving
Storage is organized by capture date, absolutely and immutably:
YYYY/YY-MM-DD/original-filename.raw
Original filenames are preserved. No albums-as-folders, no renaming schemes —
chronology is the one ordering that never needs reorganizing.
Immutable originals
Source files (RAW, master documents) are never modified. Every
adjustment — development, rating, description — lives beside the file in
open metadata: XMP sidecars or plain markdown notes. Deleting the editing
tool loses nothing.
The pipeline
Processing is three strict, extensible stages:
Ingest → Develop → Print
(import) (the look) (publish: vault note, garden, archive)
Stories are composed as local markdown notes next to the photos — the journal norm (Standard::Vault — The journal) is how a day’s photos and words meet.
Web Ingestion & Recursive Folder Drag-and-Drop
Within the web writing canvas (Writer.astro), gardeners can drag and drop entire directories of photographs directly onto the editor.
- Recursive Scanning: The
GlobalDropZonetraverses nested filesystem entries via the browser’s File System Directory API, extracting images (.jpg,.jpeg,.png,.webp,.avif). - Direct Edge Ingestion: Each image is transmitted to Cloudflare R2 via cryptographically signed upload URLs, avoiding server payload bottlenecks.
- Instant Essay Scaffolding: As uploads complete, Markdown image declarations (
) are automatically inserted with proper metadata into the active document.
Visual Essays & Gallery Mode (type: gallery)
When a note declares type: gallery in its frontmatter, the standard reading layout activates the interactive gallery engine:
- Floating Action Dock: Automatically appears when photos are clicked or selected.
- Range Selection: Visitors can click individual photos or Shift-click to select ranges across the visual essay.
- Batch ZIP Download: The dock provides a one-click action that packages selected media into a client-generated
.ziparchive via JSZip, allowing readers to easily download high-resolution photograph sets.
Implementation
Reveal and Standard Garden form the dual reference implementations: Swift shell and Python engine locally, Astro and Cloudflare R2 at the edge.