stnd.build

Prose

Rosetta Stone: Prose & Reading Measure

Inside .prose, paragraphs, headings, and lists are automatically constrained to the comfortable reading measure (var(--prose-width), default 42rem) and centered within var(--page-max-width). Child blocks can break out into wider columns using .wide or .full.

Intention HTML Class / Frontmatter CSS Token (var(...))
Long-form editorial container <article class="prose"> Reads --prose-width and --page-max-width
Flush-left editorial column <main class="prose left"> Zeroes auto horizontal margins
Constrain box to reading width (outside .prose) .max-w-prose / .max-w-line max-width: var(--prose-width)
Narrow callout / aside column .narrow max-width: var(--prose-narrow)
Wide figure / table breakout .wide / .max-w-wide Expands beyond --prose-width by --prose-wide
Edge-to-edge full bleed .full / .full-bleed Spans full viewport/container width

Prose Layout System

Layout

Prose-focused layout system for optimal reading experience with proper line lengths based on typography research (60-75 characters). Uses CSS Grid with responsive content columns for sidebars, accents, and featured content. Inspired by fine-art typography and classical book design principles.

Name Description
.prose Main article/content grid container for readable prose with named tracks.
.prose.left Left-aligned prose variant hugging the left edge.
.narrow Inset element narrower than prose reading column (var(--prose-inset)).
.wide Breakout column extending past prose reading column (var(--prose-wide)).
.full Full container width breakout track spanning to --page-max-width.
.full-bleed Full viewport width breakout track (100vw).
--prose-width Active reading column measure.
--page-max-width Overall page max-width constraint (1400px).
.hero Alias of .full: a hero block on the full-width track.
.stnd-screen-break A short centred rule that separates sections; add .screen-full for a full-screen pause.
.stnd-screen-section A section spanning every column; add .screen-full for a full-screen one.
.no-grid Turns the prose grid off on that container (and the image-gallery layout with it).
.scroll A scrolling box; one holding a table takes the wide track.
.mermaid Container for a rendered Mermaid diagram.
// Standard article with proper reading width
<article class="prose">
  <h1>Article Title</h1>
  <p>Content here stays within optimal reading width...</p>
</article>

// Narrow sidebar content
<div class="prose small">
  <p>Short form content</p>
</div>

// Featured content with emphasis
<section class="prose feature">
  <blockquote>Important quote with extra space</blockquote>
</section>

Tracks: narrow, the reading column, wide and full

<div class="prose">
  <p>A paragraph on the reading column, set to <code>--prose-width</code>.</p>
  <div class="narrow bg-background border rounded-sm p-half">narrow: inset from the reading column</div>
  <div class="wide bg-background border rounded-sm p-half">wide: breaks out of the reading column</div>
  <div class="full bg-background border rounded-sm p-half">full: spans to <code>--page-max-width</code></div>
</div>

Live

A paragraph on the reading column, set to --prose-width.

narrow: inset from the reading column
wide: breaks out of the reading column
full: spans to --page-max-width

Left-aligned prose hugs the left edge

<div class="prose left">
  <p>The reading column starts at the left edge of the container instead of being centred.</p>
</div>

Live

The reading column starts at the left edge of the container instead of being centred.

A section break, and a hero image on the full track

<div class="prose">
  <p>Text before the break.</p>
  <hr class="stnd-screen-break">
  <p>Text after it: the break is a short rule with generous space around it.</p>
  <div class="hero bg-background border rounded-sm p-half">hero: spans to the page shell, like .full</div>
</div>

Live

Text before the break.


Text after it: the break is a short rule with generous space around it.

hero: spans to the page shell, like .full

Full-bleed spans the whole viewport (shown as code: it would overflow this page)

<img class="full-bleed" src="photo.jpg" alt="">

Links to another note, and prose with the grid turned off

<p>The long version lives in <a class="mycelial-link" href="#">another note</a>, linked with a dotted underline.</p>
<div class="prose no-grid">
  <p>A <code>.no-grid</code> container is plain flow: no tracks, so <code>.wide</code> and <code>.full</code> do nothing here.</p>
</div>

Live

The long version lives in another note, linked with a dotted underline.

A .no-grid container is plain flow: no tracks, so .wide and .full do nothing here.

since 0.1.0 · see https://www.rsub.com/blog/how-long-should-a-line-of-text-be/

All classes

Other

Class Declares
.stnd-doc-live box-shadow: var(--shadow-border)