Photo Essay & Visual Story Recipe
Architectural blueprint for crafting responsive photo essays, editorial darkroom galleries, and EXIF metadata stories with zero runtime JS.
This recipe details the construction of an editorial Photo Essay & Visual Story layout, inspired by Reveal’s Story Mode and @stnd/art. In photography publishing, images are not mere decorative thumbnails — they are primary content demanding optical presence, faithful tonal reproduction, and precise technical metadata (EXIF).
Standard delivers high-fidelity visual storytelling using pure semantic HTML, responsive CSS columns, and darkroom-tuned OKLCH color palettes — with zero runtime JavaScript bloat.
Instant Scaffolding
To scaffold a photo-focused publishing project with @stnd/cli:
npx @stnd/cli new my-photo-story --template photo
cd my-photo-story
pnpm install
pnpm dev
File Structure
The entire media storytelling slice lives inside modules/story/:
my-photo-story/
astro.config.mjs # Standard core configuration
package.json # Dependencies
content/
stories/
2026-autumn-mist/
index.md # Story essay prose, title, and cover image
fuji-01.jpg # Developed high-resolution photo companion
fuji-02.jpg
leica-03.jpg
modules/
story/
index.module.js # Module manifest registering story routes
helpers.ts # EXIF metadata parser and story loader
components/
PhotoFigure.astro # Image frame with caption and EXIF pill
MasonryGrid.astro # CSS multi-column responsive gallery
DarkroomToggle.astro # Theme toggle (Light / Darkroom mode)
routes/
index.astro # Chronological index of visual stories
[...slug].astro # High-impact full-bleed photo essay view
Architectural Breakdown
1. The Story Note (content/stories/2026-autumn-mist/index.md)
Photo stories combine rich prose and companion image references:
---
title: Autumn Mist over Saint-Laurent
date: 2026-10-18
location: Île d'Orléans, Québec
cover: fuji-01.jpg
theme: technical
intention: inky
tags:
- photography
- landscape
---
At dawn, moisture from the river settled into the lowlands, transforming familiar geography into silhouettes...
![[fuji-01.jpg|Dawn light breaking through willow branches]]
We walked along the stony shore where the water was completely motionless...
![[fuji-02.jpg|Stony shoreline at low tide]]
![[leica-03.jpg|Fisherman boat mooring]]
2. Zero-JS Responsive Gallery (MasonryGrid.astro)
Rather than relying on heavy JavaScript masonry plugins, Standard achieves flawless, gapless multi-column layouts using native CSS columns and break prevention:
---
interface Props {
columns?: number;
}
const { columns = 2 } = Astro.props;
---
<div class="photo-columns" style={`--gallery-cols: ${columns};`}>
<slot />
</div>
<style>
.photo-columns {
column-count: 1;
column-gap: 1.5rlh;
margin-block: 2rlh;
}
@media (min-width: 48rem) {
.photo-columns {
column-count: var(--gallery-cols, 2);
}
}
@media (min-width: 80rem) {
.photo-columns {
column-count: calc(var(--gallery-cols, 2) + 1);
}
}
/* Prevent awkward item slicing across columns */
.photo-columns :global(figure) {
break-inside: avoid;
margin-block-end: 1.5rlh;
display: inline-block;
inline-size: 100%;
}
</style>
3. Image Frame with EXIF Metadata Pill (PhotoFigure.astro)
A photo frame displays the image, caption, and technical shooting parameters without visual clutter:
---
interface Props {
src: string;
alt: string;
camera?: string;
lens?: string;
focalLength?: string;
aperture?: string;
shutter?: string;
iso?: number;
}
const { src, alt, camera, lens, focalLength, aperture, shutter, iso } = Astro.props;
const hasExif = Boolean(camera || aperture || shutter || iso);
---
<figure class="photo-figure">
<div class="frame surface-sunken border rounded-sm overflow-hidden">
<img src={src} alt={alt} loading="lazy" decoding="async" class="block w-full h-auto" />
</div>
<figcaption class="cluster justify-between items-baseline mt-half spec text-sm">
<span class="caption-text text-foreground">{alt}</span>
{hasExif && (
<span class="exif-badge font-mono text-muted text-xs">
{[camera, lens, focalLength, aperture, shutter, iso ? `ISO ${iso}` : null]
.filter(Boolean)
.join(" · ")}
</span>
)}
</figcaption>
</figure>
<style>
.photo-figure {
margin-inline: 0;
}
.frame img {
aspect-ratio: auto;
object-fit: cover;
}
.exif-badge {
background: var(--color-surface);
padding: 0.15rlh 0.4rlh;
border-radius: var(--radius-sm, 3px);
border: 1px solid var(--color-border-subtle);
}
</style>
4. Full-Bleed Story Route (routes/[...slug].astro)
The essay layout alternates between a centered reading measure for prose and full-width bleeds for panoramic photography:
---
import StandardLayout from "@stnd/layout";
import MasonryGrid from "../components/MasonryGrid.astro";
import PhotoFigure from "../components/PhotoFigure.astro";
import { getStoryBySlug } from "../helpers";
const { slug } = Astro.params;
const story = await getStoryBySlug(slug || "2026-autumn-mist");
if (!story) return Astro.redirect("/404");
---
<StandardLayout title={story.title}>
<article class="story-article py-3">
<!-- Centered Editorial Header -->
<header class="prose reading-measure mx-auto mb-3 text-center">
<p class="spec label mb-half">{story.location} · {story.date}</p>
<h1 class="step-5 font-display text-balance">{story.title}</h1>
</header>
<!-- Full-Bleed Hero Image -->
<div class="full-bleed mb-3">
<PhotoFigure
src={story.cover}
alt={story.title}
camera="Fujifilm X-T5"
lens="XF 23mm f/1.4 R LM WR"
aperture="f/2.8"
shutter="1/500s"
iso={160}
/>
</div>
<!-- Prose Section -->
<div class="prose reading-measure mx-auto mb-3" set:html={story.proseHtml} />
<!-- Masonry Photo Grid -->
<div class="wide-measure mx-auto">
<MasonryGrid columns={2}>
{story.gallery.map((photo) => (
<PhotoFigure {...photo} />
))}
</MasonryGrid>
</div>
</article>
</StandardLayout>
<style>
.full-bleed {
inline-size: 100vw;
margin-inline-start: calc(50% - 50vw);
max-inline-size: 100vw;
}
.wide-measure {
max-inline-size: 72rem;
padding-inline: var(--gutter, 1.5rem);
}
</style>
Darkroom Mode & Contrast
In visual applications, light glare can alter perceived shadow detail. Adding [data-color-mode="dark"] transforms the surface ladder into a calibrated darkroom stage:
- Stage: Pure neutral dark
oklch(0.12 0.002 67) - Surface: Subtle elevated charcoal
oklch(0.18 0.003 67) - Foreground: Soft warm white preventing eye strain (
oklch(0.88 0.01 96))
Every token conforms strictly to the @stnd/styles monotonic elevation ladder and passes contrast conformance tests automatically.