---
name: "Manual"
slug: "manual"
generated_by: brand-guide-builder
design_md_version: 1
---

> **For the coding agent:** Place this file at your repo root — it is the brand context agents read.
> Use the exact token values below — never invent hex codes, font families, or sizes. Tokens are
> authoritative; the prose explains when and when-not. If a value isn't here, ask; don't guess.
> Suggested stack: Next.js + Tailwind v4 + shadcn/ui — prefer the `--color-*` / `--font-*` utilities.

> **Project notes from the team:**
> This is Manual's own brand — the product at usemanual.site.
> Generated from lib/manual-guide.ts: edit that file, then run `pnpm brand:design-md`. Don't edit DESIGN.md by hand.

# Manual — Brand & Design Context

## Overview

Manual is a tool for writing brand guides and publishing them to one link, as a PDF, and as design.md.

The brand looks like the thing it makes: a well-set document. Swiss in spirit — one sans family, a visible 12-column grid, hairline rules, decimal section numbers (1.0, 1.1, 2.0 …), square corners and almost no color. Restraint is the identity; the single square blue full stop is the only flourish.

- The wordmark with its clear space. — https://app.usemanual.site/brand/manual/key-visual.svg

## Colors

Almost no color: Paper and Document carry the page, Ink carries the type, and Blue appears once — the square full stop. Blue on Paper is 4.31:1: fine for the full stop and other non-text marks, not for body text. Never use orange in any shade; it is the signature color of a direct competitor.

```css
@theme {
  --color-ink: #111111;  /* Ink */
  --color-paper: #ECEAE5;  /* Paper */
  --color-document: #F7F6F2;  /* Document */
  --color-blue: #2D5BFF;  /* Blue */
  --color-folder: #C9C6BD;  /* Folder */
  --color-graphite: #55524C;  /* Graphite */
  --color-surface-light: #ECEAE5;
  --color-surface-dark: #ECEAE5;
}
```

**Approved pairings** (WCAG 2.2 AA — ratios computed by the exporter):

| Foreground | Background | Ratio | Level |
|---|---|---|---|
| `--color-ink` | `--color-paper` | 15.71:1 | AAA |
| `--color-ink` | `--color-document` | 17.46:1 | AAA |
| `--color-ink` | `--color-folder` | 11.06:1 | AAA |
| `--color-graphite` | `--color-paper` | 6.48:1 | AA |
| `--color-graphite` | `--color-document` | 7.20:1 | AAA |
| `--color-document` | `--color-ink` | 17.46:1 | AAA |
| `--color-document` | `--color-blue` | 4.79:1 | AA |

Palette dominance: Paper 40% · Ink 30% · Document 16% · Folder 12% · Blue 2%.

**Core**

| Color | Variable | Hex | Notes |
|---|---|---|---|
| Ink | `--color-ink` | `#111111` | Text, hairline rules, primary buttons, the icon field. Never pure black. |
| Paper | `--color-paper` | `#ECEAE5` | Page ground. The default background everywhere. |
| Document | `--color-document` | `#F7F6F2` | Raised surfaces on Paper: cards, panels, the guide page. |
| Blue | `--color-blue` | `#2D5BFF` | Rare accent: the full stop and the icon's square, at most one small mark per screen. Never a button, background or body text. |

**Support**

| Color | Variable | Hex | Notes |
|---|---|---|---|
| Folder | `--color-folder` | `#C9C6BD` | Quiet fills: diagram columns, disabled states, secondary blocks. Never text. |
| Graphite | `--color-graphite` | `#55524C` | Secondary text: captions, metadata, running headers. |

Design Tokens (W3C DTCG) JSON:

```json
{
  "color": {
    "ink": {
      "$type": "color",
      "$value": {
        "colorSpace": "srgb",
        "components": [
          0.0667,
          0.0667,
          0.0667
        ],
        "alpha": 1,
        "hex": "#111111"
      }
    },
    "paper": {
      "$type": "color",
      "$value": {
        "colorSpace": "srgb",
        "components": [
          0.9255,
          0.9176,
          0.898
        ],
        "alpha": 1,
        "hex": "#ECEAE5"
      }
    },
    "document": {
      "$type": "color",
      "$value": {
        "colorSpace": "srgb",
        "components": [
          0.9686,
          0.9647,
          0.949
        ],
        "alpha": 1,
        "hex": "#F7F6F2"
      }
    },
    "blue": {
      "$type": "color",
      "$value": {
        "colorSpace": "srgb",
        "components": [
          0.1765,
          0.3569,
          1
        ],
        "alpha": 1,
        "hex": "#2D5BFF"
      }
    },
    "folder": {
      "$type": "color",
      "$value": {
        "colorSpace": "srgb",
        "components": [
          0.7882,
          0.7765,
          0.7412
        ],
        "alpha": 1,
        "hex": "#C9C6BD"
      }
    },
    "graphite": {
      "$type": "color",
      "$value": {
        "colorSpace": "srgb",
        "components": [
          0.3333,
          0.3216,
          0.298
        ],
        "alpha": 1,
        "hex": "#55524C"
      }
    }
  }
}
```

## Typography

One family, sans only: ABC Areal by Dinamo. Areal has no Semibold — use 400 for text and 500 for headings, the wordmark and emphasis; 700 is reserved. Use the default a; the alternate a (stylistic set ss01) is not part of the brand. Arimo, which shares Arial's metrics, stands in where Areal can't be loaded.

```css
@theme {
  --font-sans: "ABC Areal", "Arimo", sans-serif;  /* Sans */
  --font-sans-fallback: "Arimo", sans-serif;  /* Sans · fallback */
}
```

<!-- Google Fonts: https://fonts.googleapis.com/css2?family=Arimo:wght@400;500;700&display=swap -->

| Role | Family | Size | Weight | Line-height | Letter-spacing | Note |
|---|---|---|---|---|---|---|
| display | ABC Areal | 248px | 500 | 0.76 | -0.045em | Hero lockup only |
| h1 | ABC Areal | 72px | 500 | 0.98 | -0.045em | — |
| h2 | ABC Areal | 56px | 500 | 0.9 | -0.045em | Section titles, e.g. 2.0 Logo |
| body | ABC Areal | 17px | 400 | 1.5 | 0 | Max ~65ch |
| caption | ABC Areal | 13px | 400 | 1.45 | 0 | Labels in 500 |

<!-- line-height = leadingPct / 100 · letter-spacing = trackingEm / 1000 em -->

Font tokens (W3C DTCG) JSON:

```json
{
  "fontFamily": {
    "sans": {
      "$type": "fontFamily",
      "$value": [
        "ABC Areal",
        "Arimo"
      ]
    },
    "sans-fallback": {
      "$type": "fontFamily",
      "$value": [
        "Arimo"
      ]
    }
  }
}
```

## Logo — Usage Rules

The logo is a typeset wordmark — "Manual." — set in ABC Areal Medium at -0.045em letter-spacing, with the full stop in Blue. There is no symbol. The word is Ink on light grounds and Document on Ink; the full stop stays Blue on both. The icon is a square Ink field with a centered Blue square — Areal's full stop is square, and so is everything else — used wherever the wordmark would be smaller than 16px cap height.

**Clear space:** Keep clear space equal to the cap height of the "M" on all four sides. (unit: M)

**Minimum size:** The wordmark needs at least 16px cap height on screen; below that, use the icon. Sizes: 16px, 32px, 64px.

**Don'ts:** The word is Ink or Document, the full stop Blue — nothing else. · Don't stretch or condense the wordmark. · Don't outline it. · No shadows, gradients or rounded icon corners. · Don't rotate it. · Don't fill it with images or patterns.

Assets:

- `Wordmark` — https://app.usemanual.site/brand/manual/wordmark.svg
- `Wordmark — on Ink` — https://app.usemanual.site/brand/manual/wordmark-inverse.svg
- `Icon` — https://app.usemanual.site/brand/manual/icon.svg

## Voice & Personality

Plain, exact and calm — the voice of a good manual. Short declarative sentences, sentence case, no exclamation marks, no hype ("revolutionary", "AI-powered", "magic"). Say what the thing does: "Write it down once. Share it everywhere." Use US English ("color"), matching the product UI. Numbers and structure over adjectives.

## Layout & Shape

Grid — 12 columns, 16px gutter, 48px outer margin on desktop. Lay everything on the columns: headers as 4 × 3 columns, modules as 3, 4, 6 or 8. On brand surfaces the grid may show as faint column bands (Ink at 3.5%).

Corners — radius 0 everywhere: buttons, cards, inputs, icons, images. There are no round shapes — even the full stop is square.

Rules — 1px Ink hairlines separate rows and sections. No shadows; a raised surface is Document on Paper with a 1px Ink outline.

Numbering — sections and modules carry decimal numbers (1.0, 1.1, 2.0) in 13px Medium.

Buttons — Ink fill with Document text, square, 48px tall, weight 500. Secondary actions are underlined Ink text links. Blue is never a button.

## Resources

- [usemanual.site](<https://usemanual.site/>)
- [design.md for coding agents](<https://app.usemanual.site/g/manual/design.md>)
- [ABC Areal — Dinamo](<https://abcdinamo.com/>)
