stnd.build

standard

1.0

Introduction

Standard is an editorial and interface workshop for the durable web. It lets you write in plain text and build modern applications that read, print, and age with the rigor of a Swiss typography book — governed by strict laws shared by humans and AI.

This page is set entirely by the framework's default stylesheet. Every specification printed below — every size, every color value, every ratio — is measured live from the running stylesheet as you read it. The manual cannot drift from the system, because the manualis the system, rendering itself.

npx @stnd/cli new my-project

Or add it to an existing Astro project:

npm install @stnd/core @astrojs/svelte sass-embedded

2.0

The four invariants

2.1

Beauty is default

No one should configure margins to deserve good typography. Your mother's recipe should look like it belongs in a prestige cookbook — without her doing anything.

2.2

Friction is the enemy

Ten seconds from thought to URL. Speed is a form of respect — for the writer, and for the reader.

2.3

The file is yours

Everything is plain text files. Applications are interchangeable readers. If the servers go dark tomorrow, your writing remains intact, legible, and yours.

2.4

Sustainable by architecture

Static first, edge logic, minimal JavaScript, boring technology. Efficient code is an ecological position, not a benchmark.

3.0

Choose your craft — Three entryways into Standard

Standard adapts to how you create. Whether you bring raw Markdown notes, architect edge applications, or design interface systems, choose your path:

4.0

The four layers & eight laws

Every line of code and style in Standard belongs to one of four strictly ordered layers. No inner layer may import or reach into an outer layer:

  • Layer 1 — Tokens (@stnd/styles): Pure CSS custom properties for color, typography, rhythm, and layout.
  • Layer 2 — Pure Logic: Data transformations, math, parsers, and loaders. View files hold zero business logic.
  • Layer 3 — Primitives (@stnd/ui & @stnd/layout): Accessible Astro and Svelte components styled exclusively with semantic tokens.
  • Layer 4 — Applications (apps/*): Vertical slices declared in modules/ with hermetic routes and hooks.

See The Framework Guide & Eight Lawsfor the complete architectural contract.

5.0

Everything is a module — themes, fonts, and features

You do not need the framework's source code to extend Standard. Afternpm install @stnd/core, the loader automatically discovers every *.module.js inside your project's./modules/ directory and layers it over the Core:

  • Zero-file frontmatter tokens: In a Markdown vault or note (index.md), set color-light-background,color-light-foreground, or font-textdirectly in YAML frontmatter to theme an entire site without writing a single stylesheet.
  • Local theme & private font modules: Keep licensed commercial fonts or personal themes inside your app's ownmodules/my-theme/ or modules/my-font/folder — auto-registered at build time, never leaked to public packages.
  • Feature slices & hooks: Routes, styles, and UI components live in one folder and mount into Core layouts via named hook zones (virtual:stnd/hooks). Delete the folder and the feature disappears cleanly.
// modules/my-studio/index.module.js
export default {
  id: "my-studio",
  styles: ["./fonts/licensed-font.css", "./theme.scss"],
  routes: [{ path: "/work", entrypoint: "./routes/work.astro" }],
  hooks: { "header:actions": "./components/ThemeToggle.svelte" },
};

See Add Anything to Standard,Building a Module, and Creating a Theme.

6.0

Typography

One base size, one ratio. The whole scale follows. Standard uses the silver ratio (1.414) by default for type and the golden ratio (1.618) for layout blocks. Measured now, on your screen:

Aa—--scale-5
Aa—--scale-4
Aa—--scale-3
Aa—--scale-2
Aa — body text, the measure everything serves—--scale
Aa — captions and asides—--scale-d2
Aa — metadata—--scale-d4

7.0

Color & analog warmth

Paper is never clinical pure white, and ink is never pure black. You choose an ink and a paper seed; the OKLCH engine derives the rest — surfaces, borders, dark mode, and an analog-inspired chromatic spectrum at equal perceived lightness. Measured live from the active theme:

background

—

foreground

—

accent

—

surface

—

border

—

red

—

orange

—

yellow

—

green

—

cyan

—

blue

—

purple

—

8.0

Spacing & vertical rhythm

One baseline (1rlh), plain multiples and divisions — no arbitrary magic numbers. Every gap on this page is--space scaled, measured now, on your screen:

—--space-4
—--space-2
—--space
—--space-d2
—--space-d3
—--space-d4

9.0

Table & prose

A bare <table> and unclassed prose elements — no utility classes, no wrapper divs:

TokenValueRole
--space1rlhDefault rhythm step between blocks
--scale1rem (fluid)Body text measure
--color-accentOKLCH seedLinks, focus rings, active markers
Line length isn't a style choice. Past 75 characters the eye loses its place on the way back to the left margin.

A paragraph at reading width (--prose-width), with aninline link, someinline code, and a short list:

  • One idea per line
  • No decoration without a job
  • The measure serves the reader, not the layout

10.0

Applications in the field

Standard Garden — a quiet place to think in public. Write in Obsidian or plain Markdown; publish a durable URL in ten seconds.

Reveal — a native macOS RAW photo workflow application (Tauri 2, Rust, wgpu, Svelte 5) built on the same token architecture and file-first principles.