# Usage guide

> Approved by Dan, 14 Oct 2026 (direction C, Emergence). Pamela's review pending (round 1).

## Choosing a logo form

| Form | File stem | Use it for | Minimum (screen / print) |
| --- | --- | --- | --- |
| Icon | `pamela-woods-icon` | Avatar, favicon, app icon, watermark-free sign-off, social profile | 16 px / 5 mm (use the `micro` drawing at 16–32 px) |
| Lowercase wordmark | `pamela-woods-wordmark-lowercase` | Site header, footer, print where the icon appears elsewhere | 120 px / 30 mm wide |
| Uppercase wordmark | `pamela-woods-wordmark-uppercase` | Labels, captions, wall text, small print, spine text | 110 px / 28 mm wide |
| Horizontal lockup | `pamela-woods-horizontal` | Primary lockup for headers, email, letterheads | 140 px / 35 mm wide |
| Stacked lockup | `pamela-woods-stacked` | Square or narrow spaces, title pages, posters | 120 px / 30 mm wide |
| With tagline | `pamela-woods-horizontal-tagline`, `-stacked-tagline` | Introductions: Open Graph, first-contact print, exhibition material | 240 px / 60 mm, 160 px / 40 mm |
| Compact | `pamela-woods-compact` | Small headers, dashboard top bar, mobile menus | 120 px / 30 mm wide |

The tagline is set in Instrument Sans, sentence case. Do not retype it: use the lockup files.

## Clear space

- **Lockups and the icon:** the unit **x** is the height of the icon's ground block, the part below the horizon. Keep **1x** clear on every side.
- **Wordmark on its own:** x is the lowercase x-height.
- **Uppercase wordmark:** x is 0.6 × the cap height.
- The diagrams are in `01-identity/04-clear-space/`, and the numbers in `clear-space.json`.
- The SVGs are trimmed tight to the artwork, so add the clear space in layout.
- Keep at least **2x** between any logo and the edge of an artwork.

## Light, dark and one-colour

- `light` files are for light grounds (Ink #1E1D1A). `dark` files are for dark grounds (Paper #F5F2EB).
- Use `black` or `white` only where a single colour is required: engraving, one-colour print, embossing.
- **Never place a mark over an artwork.** Place it on a calm ground beside or below the work.

## Do

- Scale proportionally from the SVG masters, and regenerate rasters with `pnpm brand:build`.
- Let the artwork supply the colour. Use Understorey and Clay sparingly: links, focus rings and single highlights.
- Use the adaptive `favicon.svg` together with the fallback `favicon.ico`.
- Set titles of works in Fraunces italic. Set metadata (year · medium · dimensions in cm) in Instrument Sans with tabular figures.

## Don't

| | |
| --- | --- |
| ![](01-misuse/misuse-1-do-not-stretch-or-squash.png) | ![](01-misuse/misuse-2-do-not-recolour.png) |
| ![](01-misuse/misuse-3-no-effects-outlines-or-shadows.png) | ![](01-misuse/misuse-4-do-not-rotate.png) |
| ![](01-misuse/misuse-5-never-on-low-contrast-grounds.png) | ![](01-misuse/misuse-6-do-not-rearrange-icon-and-wordmark.png) |

Also:

- Don't retype the wordmark in a font.
- Don't change the letter spacing.
- Don't fill the lens with an image.
- Don't use patterns behind body text at more than the supplied opacity.
- Don't sample colours from artworks to recolour the marks.

## Typography

**Primary:** Fraunces (display, headings, artwork titles). **Secondary:** Instrument Sans (body, UI, labels, metadata). Both are SIL OFL 1.1. The full scale is in `01-identity/05-typography/type-scale.json`, with a specimen in `type-hierarchy-*.png`.

| Role | Face | Web size / line height | Tracking | Print |
| --- | --- | --- | --- | --- |
| Display | Fraunces 300 | clamp(2.75rem, 5vw + 1rem, 4.5rem) / 1.05 | −0.01em | 36–60 pt |
| H1 | Fraunces 300 | clamp(2.5rem, 2vw + 2.1rem, 3.9rem) / 1.1 | −0.005em | 28 pt |
| H2 | Fraunces 400 | clamp(2rem, 0.39vw + 1.92rem, 2.275rem) / 1.2 | 0 | 20 pt |
| H3 / subhead | Fraunces 400 | clamp(1.5rem, 0.41vw + 1.418rem, 1.7875rem) / 1.3 | 0 | 15 pt |
| Body | Instrument Sans 400 | 1.0625rem / 1.6 | 0 | 10/15 pt |
| Body small | Instrument Sans 400 | 0.9375rem / 1.55 | 0 | 8.5/13 pt |
| Caption | Instrument Sans 400, Stone | 0.8125rem / 1.45 | 0.01em | 7.5 pt |
| Label / eyebrow | Instrument Sans 500, capitals | 0.75rem / 1.3 (never below 12 px) | 0.14em | 7 pt |
| Button | Instrument Sans 500, sentence case | 0.9375rem / 1 | 0.02em | — |
| Artwork title | Fraunces 400 italic | 1.25rem / 1.3 | 0 | 12 pt |
| Artwork metadata | Instrument Sans 400, tabular figures | 0.875rem / 1.5 | 0 | 8 pt |
| Numerals | Instrument Sans 500 | `font-variant-numeric: tabular-nums lining-nums` | | |

**Web-font loading:**

- Self-host the woff2 files in `05-typography/fonts/` with `02-tokens/fonts.css`. Use `font-display: swap`.
- Preload only Fraunces 300 and Instrument Sans 400.
- The fallback stacks are in `tokens.css`: Iowan or Palatino or Georgia for Fraunces, system-ui for Instrument Sans.
- Don't load the fonts from Google's CDN: self-hosting avoids a third-party request and a privacy notice.

## Colour

| Role | Light | Dark | Use |
| --- | --- | --- | --- |
| ink | #1E1D1A | #F2EEE6 | Text, marks |
| paper | #F5F2EB | #1A1917 | Page ground, artwork mount |
| bone | #ECE7DD | #262420 | Cards, raised surfaces, inputs |
| stone | #5F5B54 | #B3ACA0 | Secondary text, captions |
| rule | #D6CFC2 | #3A3732 | Hairlines only, never text |
| border | #8C857A | #7D776D | Input and checkbox outlines (≥ 3:1) |
| understorey | #3D4A3C | #A9BBA5 | Links, selected states |
| clay | #A2553A | #E0906F | Focus ring, single highlights |
| link | #1F6F6B | #7CC7C0 | Text links: teal, bold, never underlined, grow slightly on hover |
| lichen | #8E957F | #6E745F | Pattern tint only |

HEX, RGB, HSL and approximate CMYK values are in `01-identity/06-colour/palette.json`. **The CMYK figures are naive conversions, not print-accurate.** Ask the printer for a proof on the chosen stock.

The full WCAG 2.2 matrix is in `01-identity/06-colour/contrast-matrix.md`. These pairs are relied on and checked by the build:

| Pair | Light | Dark | Passes |
| --- | --- | --- | --- |
| ink / paper | 15.08:1 | 15.18:1 | AAA text |
| stone / paper | 6.04:1 | 7.80:1 | AA text (AAA in dark) |
| stone / bone | 5.48:1 | 6.88:1 | AA text |
| understorey / paper | 8.37:1 | 8.65:1 | AAA text |
| clay / paper | 4.82:1 | 7.02:1 | AA text; UI and focus |
| border / paper | 3.27:1 | 3.96:1 | AA UI components only (not text) |

`rule` and `lichen` fail as text by design: they are decorative only.

## Patterns

- There are three systems: **strata** (layered contour lines), **growth** (phyllotaxis rosettes) and **seed** (scattered lens forms, at the icon's angle).
- The tiles are seamless at 480 units. They are tinted Understorey at 32–34% opacity, so text on top keeps its contrast. This was checked visually in `90-build/02-qa/contact-patterns.png`.
- Use patterns for empty states, section dividers, the Open Graph default, packaging and the backs of cards. **Never behind or over artwork.**
- The grain texture peaks at 9% alpha. Use it as an overlay on flat grounds only.

## Platform icons

- 83 icons on a 24 px grid, with a 1.5 px stroke, round caps and joins, and 1.5–2 px radii. Keep them at 24 px, or at 20 or 16 px only if you keep the 1.5 stroke.
- The social glyphs (Instagram, Facebook, LinkedIn, YouTube, Bluesky, X, Pinterest) are **neutral placeholders**. Link them only to handles Pamela has confirmed.
- They are not the platforms' official logos. If a platform's brand rules require its own logo, use that instead.

## Motion

- Motion confirms an action and is over in under 250ms. Durations come from the tokens (`--pw-duration-instant` 100ms, `fast` 150ms, `base` 200ms, `sheet` 250ms); never hard-code one.
- **Reveal:** page endings, cards, event entries and prose headings ease up 1.25rem into place as they scroll into view. One-shot, scroll-driven, never on artwork, the header or anything above the fold.
- **Wash:** on hover or keyboard focus a pastel, earthy tint blooms from a card's top-left corner. Six hues in turn (lichen, clay, link, understorey, clay-and-lichen, border), each mixed into paper, so no new colour enters the palette.
- Both are removed under reduced motion (system setting or the visitor's accessibility panel): content is simply present and the tint appears at once.

## Page endings and media kit

- Every page closes with the same three blocks, in order: **Questions people ask** (that page's own questions, first person, to Pamela), **Next steps** (contained cards with a photograph) and the newsletter panel.
- The media kit is eight cards: full media kit, logo (light and dark), icon, biography and statement, exhibitions and events, images of works, brand guidelines. It is shared by Press and Galleries.
- Full detail and values: `.stitch/DESIGN.md` › Motion, Page endings, Media kit cards.
