stnd.build

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]]

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:

Every token conforms strictly to the @stnd/styles monotonic elevation ladder and passes contrast conformance tests automatically.