# mrfrisby.com design reference

For coding agents building something **on-brand but off-domain** (a different site, app or page that should feel like mrfrisby.com). Fetch this file, then apply it.

- This file: `https://mrfrisby.com/brand.md`
- Drop-in tokens, fonts and base styles: `https://mrfrisby.com/brand/mrfrisby-tokens.css`
- Live examples: `https://mrfrisby.com/`, `/projects`, `/notes`, `/colours`
- Source of truth: `src/styles/global.css` and `src/styles/layout.css` in the mrfrisby.com repo. If this document and the code disagree, the code wins.

## How to use this

1. Link the tokens stylesheet: `<link rel="stylesheet" href="https://mrfrisby.com/brand/mrfrisby-tokens.css">`. It loads the fonts, defines every colour as a CSS variable (dark by default, light when the system asks for it) and sets the page base.
2. Style everything with the variables. Never hard-code a colour from this document.
3. Build the page inside the frame (see Layout), set headings in Oswald, body in Barlow.
4. Check the result against Do and Don't at the end.

If you can't load external CSS, copy the tokens file into your project. It is self-contained.

## The feel

A green world, drawn with hairlines. The page is a plain field of colour inside a thin frame, with type doing nearly all the work. Headings are big, condensed, uppercase Oswald. Body text is light Barlow. Structure comes from 1px rules, not boxes, fills or shadows. Colour is almost entirely one hue (green); the single warm accent is a red, used rarely.

Dark mode is a near-black with a trace of green. Light mode is a saturated pale green (not white). Both are first-class: always support both, following `prefers-color-scheme`.

## Colour

Use the variables, not the values. Nine tokens, same names in both modes.

| Token | Role | Dark | Light |
|---|---|---|---|
| `--bg` | Page background | `#111411` | `#afe4c8` |
| `--bg-surface` | Cards, panels | `#171b17` | `#95dfb8` |
| `--bg-elevated` | Raised elements | `#1e231e` | `#7fd7a8` |
| `--border-subtle` | Dividers, quiet outlines | `#2a312a` | `#6fc899` |
| `--border` | Frame, interactive borders | `#3f493f` | `#4ab07a` |
| `--text-mid` | Secondary text, labels, metadata | `#a3aea3` | `#2f513f` |
| `--text` | Primary text | `#ebefeb` | `#020303` |
| `--accent` | Links on hover, focus, highlights | `#3ddc84` | `#1a7a42` |
| `--opposite` | Selection, rare contrast | `#d5150b` | `#fcc8c5` |

The tokens file also carries OKLCH versions for capable browsers. They are the same colours in a wider gamut; don't mix the two systems.

Rules for using colour:
- Text is `--text`, or `--text-mid` for anything secondary. Never grey out text with opacity.
- Surfaces step up in this order: `--bg`, `--bg-surface`, `--bg-elevated`. Use them sparingly; most of a page is `--bg`.
- `--accent` is for focus rings, hover emphasis and small marks. It is not a button fill or a large area.
- `--opposite` is the selection colour (`::selection`). Don't use it for errors or buttons.
- Individual pages and projects may bring their own accent hue (the projects page gives each project one, and note pages have their own palettes). Treat that as a per-page decision, set as a local variable, never as a change to the nine tokens. Keep any page accent to one hue.

## Type

Three families, all served from `https://mrfrisby.com/fonts/` (the tokens file declares them).

| Use | Family | Weight | Notes |
|---|---|---|---|
| Headings, labels, links, buttons | **Oswald** | 700 (variable 600 to 700) | Always uppercase. Tracked wider as it gets smaller. |
| Body | **Barlow** | 300 | Light. Base size 16px. Relaxed line height, about 1.5. |
| Typewriter flourishes | **Special Elite** | 400 | Occasional. For letters, forms, a little theatre. |
| Metadata | system monospace | regular | Small, e.g. `0.72rem`, in `--text-mid`. |

Specifics:
- **Page title / display:** Oswald 700, uppercase, line-height 0.8 to 1, slight negative tracking (`-0.02em`) when very large. Often set as large as the frame will carry; the home and section pages set the name edge to edge.
- **Headings:** Oswald 700 uppercase, `clamp(1.8rem, 4vw, 2.8rem)` for a section name, line-height 1.
- **Labels and links:** Oswald 700, `0.55rem` to `0.75rem`, uppercase, letter-spacing `0.14em` to `0.22em`.
- **Body:** Barlow 300, about `1.05rem`, line-height about 1.55, measure up to ~30rem for short copy and ~65ch for long text. `text-wrap: pretty`.
- **Links in prose:** underlined with a quiet `--border-subtle` line that thickens and offsets on hover.
- Never fake bold on Barlow. If you need emphasis in body text, use `--text` against `--text-mid`, or italics sparingly.

## Layout

- **The frame.** The whole page sits inside one `1px solid var(--border)` box inset from the viewport (`margin: 1.25rem 1.5rem`, `0.75rem` on phones). Everything lives inside it. Use the `.page-frame` class from the tokens file.
- **Gutters.** Horizontal padding is `var(--pad)` (1.75rem) and is applied only by the `.col-pad` class, never ad hoc by children. Full-bleed elements (rules, hero bands, images) go edge to edge inside the frame.
- **Structure is rules.** Separate sections with `.rule-thin` (1px `--border`), `border-top: 1px solid var(--border-subtle)` for quieter breaks, or `.rule-heavy` (2px `--text`) for emphasis. Prefer a rule to a box or a background change.
- **Section labels.** A small tracked Oswald label with a hairline running out to the right (`.section-label`), or centred between two rules. It is the standard way to start a section.
- **Two columns.** Equal columns divided by one `border-left` on the right column. Stack to one column under 640px with a top border instead.
- **Page header.** A full-width hero band with the page name in huge Oswald uppercase, a hairline under it, then one quiet row: a short descriptor on the left in `--text-mid`, a link home on the right. The band can be a flat colour or a slow-drifting soft gradient of one or two hues with fine grain over it. In dark mode, tone any bright band down (a `backdrop-filter: saturate(0.7) brightness(0.8)` veil) so it doesn't glare.
- **Footer.** One quiet row at the bottom of the frame: small text in `--text-mid`, links underlined with `--border`.

## Components

Keep components small and flat. Reference classes live in the tokens file.

- **Text link (CTA):** `.link`. Oswald 700, uppercase, tracked, underlined; the underline thickens on hover. This is the primary call to action. There is no filled button as a house style.
- **Pill:** `.pill`. 1px border, fully rounded, tracked Oswald capitals. Used for categories and filters. A selected pill fills with its colour and switches to dark text.
- **Card / media frame:** `1px solid var(--border-subtle)`, `border-radius: 6px`, `--bg-surface` behind the image. Radii are small: 2 to 6px for frames, 4px for key-style controls, fully round only for pills and dots.
- **Dot:** a small filled circle (about 9px) in a category colour, used beside metadata.
- **Heading with accent rule:** an uppercase Oswald name with a 3px underline in a project's own colour, sitting under the text and no wider than it.
- **Metadata line:** small monospace in `--text-mid`, optionally led by a dot.
- **Key-cap control:** a small bordered rectangle (`--bg-surface`, 1px `--border`, 4px radius) used for arrows and small controls, which presses down on hover.
- **Focus:** a 2px `--accent` outline with 2px offset on every focusable element. Always keep it.

## Motion

- Short and calm. Colour and underline transitions are about 0.15 to 0.2s `ease`.
- Hover on image frames can lift slightly (`scale(1.02)`) over about 0.25s.
- Between pages, use the browser's own cross-document view transition (`@view-transition { navigation: auto; }`): the old page fades out in about 0.2s, the new one rises 12px and fades in over about 0.3s. No client-side router.
- Ambient motion (the hero band's drifting gradient) is slow, tens of seconds per cycle.
- Respect `prefers-reduced-motion` everywhere. The tokens file already zeroes durations.

## Voice, if you write copy

- Clarity first. Short declarative sentences. Lyrical is welcome only when it is also the clearest way to say the thing.
- Dry, understated, specific. Land on a concrete detail, not a summary.
- No throat-clearing ("it's worth noting", "here's the thing", "at the end of the day", "let's unpack").
- Lower-case, slash-style names for navigation (`/notes`, `/projects`), uppercase only through CSS for headings and labels.
- Honest hedging is fine, once. Don't stack qualifiers.

## Do

- Use `var(--token)` for every colour, and support light and dark.
- Put the page inside the hairline frame and let rules do the structuring.
- Set headings in uppercase Oswald 700 and body in Barlow 300.
- Make type big and let it carry the page.
- Keep one accent hue per page.
- Keep corners small, controls flat, and focus rings visible.
- Give any logos or marks in a row a single colour (black in light mode, white in dark) and identical dimensions.

## Don't

- Don't use pure white or pure black backgrounds, or a grey ramp. The neutrals here are green-tinted.
- Don't use another typeface for headings or body. No Inter, Roboto, Helvetica or system sans as a stand-in.
- Don't fill buttons with the accent, add gradient buttons, or use heavy drop shadows. A faint shadow on a lifted image frame is the only one.
- Don't wrap everything in rounded cards. Prefer rules; use a card only when something is a self-contained object.
- Don't use more than one accent hue on a page, and don't recolour the nine tokens.
- Don't add emoji as decoration or stock-illustration styles.
- Don't centre-align body text. Centre only labels, hero lines and short captions.
- Don't ignore dark mode or reduced motion.

## Worked example

A minimal on-brand page. Copy it as a starting point.

```html
<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Example</title>
  <link rel="stylesheet" href="https://mrfrisby.com/brand/mrfrisby-tokens.css">
  <style>
    .hero { padding: 3rem var(--pad) 2rem; border-bottom: 1px solid var(--border); }
    .hero h1 { font-size: clamp(3rem, 12vw, 9rem); letter-spacing: -0.02em; line-height: 0.82; }
    .hero p { margin-top: 1rem; color: var(--text-mid); max-width: 30rem; font-size: 1.05rem; line-height: 1.55; }
    .item { padding: 2rem var(--pad); border-top: 1px solid var(--border-subtle); display: grid; gap: 0.9rem; }
    .section-label + .item { border-top: 0; }
    .item > .pill { justify-self: start; }
    .item h2 { font-size: clamp(1.8rem, 4vw, 2.8rem); padding-bottom: 0.55rem; border-bottom: 3px solid var(--accent); align-self: start; justify-self: start; }
  </style>
</head>
<body>
  <div class="page-frame">
    <header class="hero">
      <h1>Example</h1>
      <p>A short line of copy in Barlow Light, in the secondary colour.</p>
    </header>

    <div class="section-label">Things</div>

    <section class="item">
      <p class="meta">2026 · Web app</p>
      <h2>First thing</h2>
      <p>One or two plain sentences about it. <a href="#">A link in prose</a> underlines quietly.</p>
      <a class="link" href="#">See it</a>
    </section>

    <section class="item">
      <span class="pill">Category</span>
      <h2>Second thing</h2>
      <p>The structure is rules, the type is big, and colour comes from the tokens.</p>
      <a class="link" href="#">See it</a>
    </section>
  </div>
</body>
</html>
```

## Fonts and licences

Oswald, Barlow and Special Elite are open-licensed and served from `https://mrfrisby.com/fonts/` with CORS enabled, so they load from any domain. Other fonts on mrfrisby.com (Maple Mono, Press Start 2P, Bluu Next) are used on specific pages for specific effects and are not part of the core brand. Don't use them unless asked.

## Updating this reference

Maintained in the mrfrisby.com repo at `public/brand.md` and `public/brand/mrfrisby-tokens.css`. Update both when `src/styles/global.css` changes.
