# Site design

Address: https://nowa.im/cotty/handbook/site-design/  
Status: Draft  
Created: 2026-11-22

This page defines how the site looks: its grid, its type, its colors, and the details it takes from the history of the terminal. The stylesheet `site/assets/css/site.css` implements it. Where the two disagree, this page governs.

## The idea

The whole is plain and the detail is local. Three decisions carry the design.

- **One grid.** The page is a screen, measured in characters. Its widths are the widths of the terminals that came before it.
- **Two voices.** Prose is set in a sans-serif face. Labels, metadata, navigation and code are set in a monospace face. A person speaks, and the machine labels.
- **Two colors.** Blue marks where you can go. Rose marks where you are, and what needs you.

A line is drawn only where it says something: the status line, the rules of a table, the mark at the end of a page. There is no rule under the header and none above the footer.

## Grid

One column is the width of one character of code.

| Part | Columns | Least width | Why |
|---|---|---|---|
| Text | 80 | 36 rem | The width of the VT100 screen. A line of 80 characters of code fits without scrolling. |
| Navigation | 24 | 12 rem | |
| Contents of the page | 20 | 10 rem | |
| Gutter, twice | 4 | 2 rem | |
| Whole page | 132 | | The wide mode of the VT100. |

- The least widths keep the page readable when the reader's code font is narrow. They hold nearly the same proportions.
- A code block hangs two columns into each margin. Its text lines up with the prose, and its 80 columns stay whole.
- A screen too narrow for three parts folds the contents of the page into a line above the text. A narrower one moves the navigation below the text.
- A table wider than the text scrolls sideways inside its own box.

## Type

- **Faces.** The reader's own system fonts, sans-serif and monospace. No font is downloaded.
- **Size.** Body text is 17 px.
- **Scale.** Each step multiplies by the square root of the golden ratio, about 1.272. Two steps multiply by the golden ratio.

| Step | Size | Used for |
|---|---|---|
| −1 | 0.786 rem | Labels, metadata, code |
| 0 | 1 rem | Body text |
| 1 | 1.272 rem | Third-level headings |
| 2 | 1.618 rem | Second-level headings |
| 3 | 2.058 rem | The title of a page |
| 4 | 2.618 rem | The height of the paper tape |
| 6 | 4.236 rem | The name on the home page |

- **Rhythm.** A line of body text is 1.618 rem high. This is a row. The space between paragraphs is a row divided by the golden ratio, which is 1 rem. Smaller spaces divide again: 0.618 rem and 0.382 rem. Larger ones are whole rows.

## Color

### Palette

The light theme is Paper and the dark theme is Glass. The page follows the setting of the reader's system.

| Token | Paper | Glass | Used for |
|---|---|---|---|
| `--paper` | `#ffffff` | `#070b18` | The page |
| `--surface` | `#f3f5fb` | `#0f1528` | Code blocks, inline code, keys |
| `--ink` | `#0a0f1f` | `#eef1fa` | Text |
| `--ink-2` | `#454e69` | `#a9b2cc` | Secondary text |
| `--ink-3` | `#5e6781` | `#7f89a6` | Labels, marks, the edge of a field |
| `--rule` | `#d3d9e8` | `#27304d` | Hairlines. Never the only sign of anything |
| `--blue` | `#0047ff` | `#7aa5ff` | Links, structure, settled status |
| `--rose` | `#db0a6c` | `#ff6ba6` | Text and fills that ask for attention |
| `--rose-signal` | `#ff1f7a` | `#ff5c9d` | Marks only: the current place, the focus ring, the name |

Contrast against the page, by the WCAG 2 formula:

| Token | Paper | Glass | Least allowed |
|---|---|---|---|
| `--ink` | 19.1 | 17.4 | 7 |
| `--ink-2` | 8.3 | 9.3 | 7 |
| `--ink-3` | 5.6 | 5.6 | 4.5 |
| `--blue` | 6.3 | 8.1 | 4.5 |
| `--rose` | 4.9 | 7.4 | 4.5 |
| `--rose-signal` | 3.7 | 6.8 | 3 |

The same floors hold against `--surface`. A check reads the stylesheet and fails when a token falls below its floor, or when the stylesheet and the palette table above differ.

### Rules

1. **Blue marks where you can go.** Links, the mark under a heading, the data holes of the tape, a status that is settled.
2. **Rose marks where you are and what needs you.** The current section and page, the heading being read in the contents of the page, the focus ring, a status that waits for a decision, a match in the search results, the edge of a quotation.
3. **Rose is rationed.** Attention is scarce, so the color that asks for it is scarce. A view holds more blue than rose, and far more ink than either.
4. **No third hue.** There is no green for good and no red for bad. A status is told by its word and by its shape, never by its color alone.
5. **`--rose-signal` is for marks.** It does not reach the contrast that small text needs on Paper. It is used for shapes, and for the name, which is large and bold.
6. **Tints are mixed, not added.** A highlight is a token mixed into the page at a fixed share. No new color enters the palette.

### Status

| Status | Color | Shape |
|---|---|---|
| `draft`, `planning` | Rose | Outline |
| `discussion`, `active` | Rose | Filled |
| `accepted` | Blue | Outline |
| `implemented`, `shipped` | Blue | Filled |
| `rejected`, `withdrawn`, `superseded` | Ink | Dashed outline, struck through |

An outline is the earlier state and a fill is the later one. A filled status is set in reverse video.

## Details from the history of the terminal

| Detail | Where | What it comes from |
|---|---|---|
| Paper tape | Under the title of every page | The teletype read and punched eight-level paper tape. |
| The name in two colors | Header, home page, footer | cotty is co + tty, and tty is short for teletype. |
| Block cursor | After the name | The cursor of the video terminal. |
| Underline cursor | Under each second-level heading | The other cursor shape of the VT100. |
| Reverse video | Filled statuses, selected text | The attribute a video terminal uses to make text stand out. |
| 80 and 132 columns | The grid | The two widths of the VT100 screen. |
| Paper and Glass | The names of the themes | A teletype printed on paper. The first video terminals were called glass teletypes. |
| `EOT` | The end of every page | End of transmission, the control character 04 of ASCII. |
| The `/` key | Search | The search command of ed, and later of vi and less. |
| A shell session | The page for an address that does not exist | The message a shell prints for a file that does not exist. |

### The paper tape

- The tape under a title is that title, in UTF-8, one column of holes for each byte.
- The least significant bit is at the top. Three data tracks lie above the feed track and five below it, as on real tape.
- The proportions are those of real tape: tracks and columns 0.1 inch apart, data holes 0.072 inch across, feed holes 0.046 inch.
- Data holes are blue. The feed holes, which mark time, are rose.
- A title longer than 64 bytes is cut at 64.
- The tape is decoration. It is hidden from screen readers.

### The cursor

The cursor blinks four times and then rests. Nothing on a page moves for more than five seconds. It does not blink at all for a reader who has asked for reduced motion.

## Access

- Text meets the contrast floors in the tables above.
- Every control shows a rose ring when the keyboard reaches it.
- The first link on a page skips to the text.
- A link that leaves the site carries an arrow.
- Printed pages drop the navigation and print the addresses of links.
