# Writer — Design Reference
> quiet graphite desk, one amber cursor

**Source:** https://writer.computer  
**Theme:** dark  
**Category:** Productivity  
**Mood:** dark, minimal, technical, monochrome, typographic, calm  
**Captured:** 2026-11-12

## Overview

A near-black product page that behaves like a native macOS app window: system sans at system sizes, no decoration, no shadows, and a single warm amber used sparingly as the blinking-cursor accent. The left column is pure typography — a 48px system-font headline, a dark pill CTA, and a tight list of feature pairs where the label is white and the description drops to cool grey — while the right half is given over to screenshots that sit on faint white-on-black panels. Docs switch the headline to a serif, which is the only overt editorial gesture in the whole system.

Technically it is a three-surface dark stack (#121212 ground, #303030/#323232 raised) with hairlines made from white at 10–16% opacity rather than solid greys. Type is -apple-system throughout at 400/500/590, with Departure Mono at 12px/0.84px tracking used as decorative ASCII texture in page headers. Radii are uniform at 12px, spacing clusters on a 4px grid with 20px as the workhorse padding, and there are no shadows anywhere — depth comes entirely from surface value steps.

## Tokens — Colors

| Name | Value | Token | Role |
|---|---|---|---|
| Graphite Ground | `#121212` | `--color-bg` | Page background on every route, including docs and mobile |
| Slate Riser | `#323232` | `--color-surface` | Primary CTA fill, badge fill, raised chips |
| Slate Subtle | `#303030` | `--color-surface-subtle` | Doc cards and low-contrast panels on the ground |
| Slate Hover | `#3f3f3f` | `--color-surface-hover` | Hover state for the primary button and cards |
| Paper White | `#ffffff` | `--color-text` | Headline, nav links, feature labels, button labels |
| Chalk | `#f7f8f8` | `--color-text-strong` | Docs H1 and card titles — a hair softer than pure white |
| Fog | `#d0d6e0` | `--color-text-secondary` | Docs body copy and sidebar links |
| Cool Ash | `#8a8f98` | `--color-text-muted` | Feature descriptions, version number, captions, card body |
| Cursor Amber | `#e17909` | `--color-accent` | Logo cursor bar, ASCII header glyph highlights, link/focus accent |

### Semantic roles

| Role | Value |
|---|---|
| background | `#121212` |
| surface | `#303030` |
| surface raised | `#323232` |
| border | `rgba(255,255,255,0.10)` |
| text | `#ffffff` |
| text muted | `#8a8f98` |
| primary | `#323232` |
| primary text | `#ffffff` |
| accent | `#e17909` |
| warning | `#e17909` |

## Tokens — Typography

- **Body:** -apple-system (400, 500, 590) — fallbacks: BlinkMacSystemFont, SF Pro Display, system-ui, Inter, Segoe UI, sans-serif. Everything UI-facing. The 590 weight is SF Pro's semibold optical step used for docs card titles; substitute 600 off-Apple.
- **Display:** ui-serif (400) — fallbacks: New York, Georgia, Times New Roman, serif. Only used for docs page H1 ('Overview') at 48px/400 — an editorial counterpoint to the system sans.
- **Mono:** Departure Mono (400) — fallbacks: ui-monospace, SF Mono, Menlo, monospace. 12px pixel mono used as dense ASCII texture in docs page headers and for version strings; never for body copy.

| Role | Size | Line height | Weight | Letter spacing | Family |
|---|---|---|---|---|---|
| Display / H1 | 48px | 1 | 400 | -0.02em | body |
| Docs H1 (serif) | 48px | 1 | 400 | 0 | display |
| Card Title | 17px | 1.4 | 590 | -0.012em | body |
| Lead | 17px | 1.6 | 400 | 0 | body |
| Body | 16px | 1 | 400 | 0 | body |
| Small / UI | 14px | 1.5 | 400 | -0.013em | body |
| Nav / Button | 14px | 1 | 500 | 0 | body |
| Caption | 12px | 1 | 500 | 0 | body |
| Mono texture | 12px | 1.25 | 400 | 0.07em | mono |

## Tokens — Spacing & Layout

- **Base unit:** 4px
- **Density:** comfortable
- **Container max width:** 1200px
- **Section gap:** 64px
- **Card padding:** 20px
- **Scale:** 2px, 4px, 8px, 12px, 20px, 24px, 32px, 36px, 64px

## Tokens — Radius

| Element | Value |
|---|---|
| Buttons, cards, screenshot panels, nav GitHub pill | 12px |
| Badges and small chips | 8px |
| Hairline dividers / full-bleed panels | 0 |

## Tokens — Shadows

| Name | Value | Usage |
|---|---|---|
| none | `none` | No elevation shadows anywhere. Depth is expressed purely by stepping surface value (#121212 → #303030 → #323232) and 10% white hairlines. |

## Components

### Primary CTA (Download for MacOS) (button)

| Property | Value |
|---|---|
| background | `#323232` |
| color | `#ffffff` |
| border | `none` |
| radius | `12px` |
| padding | `12px 20px` |
| font size | `14px` |
| font weight | `500` |
| shadow | `none` |
| hover | `background: #3f3f3f` |

Leading Apple glyph at 14px, 8px gap to the label. Deliberately low-contrast — the CTA is a raised grey slab, not a coloured button.

### Ghost Nav Button (GitHub) (button)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#ffffff` |
| border | `1px solid rgba(255,255,255,0.14)` |
| radius | `12px` |
| padding | `10px 20px` |
| font size | `14px` |
| font weight | `500` |
| shadow | `none` |
| hover | `border-color: rgba(255,255,255,0.28); background: rgba(255,255,255,0.04)` |

The only outlined element in the header; sits at the end of a 40px-tall nav row.

### Top Navigation (nav)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#ffffff` |
| border | `none` |
| radius | `0` |
| padding | `20px 32px` |
| font size | `14px` |
| font weight | `500` |
| shadow | `none` |
| hover | `color: #ffffff; opacity: 0.7` |

Static (not sticky), no blur, no bottom rule. Blackletter 'w' wordmark on the left with an amber #e17909 caret bar beside it; Docs / Updates text links then the ghost GitHub pill, spaced ~64px apart.

### Docs Card (card)

| Property | Value |
|---|---|
| background | `#303030` |
| color | `#8a8f98` |
| border | `1px solid rgba(255,255,255,0.06)` |
| radius | `12px` |
| padding | `20px` |
| font size | `14px` |
| font weight | `400` |
| shadow | `none` |
| hover | `background: #3f3f3f` |

Two-column grid, 24px gap. Title 17px/590 in #f7f8f8, body 14px/1.5 in #8a8f98. No icons, no arrows.

### Version Badge (Beta) (badge)

| Property | Value |
|---|---|
| background | `#323232` |
| color | `#d0d6e0` |
| border | `none` |
| radius | `8px` |
| padding | `4px 8px` |
| font size | `10px` |
| font weight | `500` |
| shadow | `none` |
| hover | `none` |

Paired with a bare 'v0.8.0' in #8a8f98 at 12px, 8px to its right, both baseline-aligned with the CTA.

### Feature Pair Row (other)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#8a8f98` |
| border | `none` |
| radius | `0` |
| padding | `0` |
| font size | `16px` |
| font weight | `400` |
| shadow | `none` |
| hover | `none` |

Inline label + description on one line: label #ffffff 16px/400, description #8a8f98 with an 8px gap; rows stacked at ~28px rhythm. Replaces a conventional feature grid entirely.

### Screenshot Panel (other)

| Property | Value |
|---|---|
| background | `rgba(255,255,255,0.06)` |
| color | `#ffffff` |
| border | `1px solid rgba(255,255,255,0.10)` |
| radius | `12px` |
| padding | `0` |
| font size | `16px` |
| font weight | `400` |
| shadow | `none` |
| hover | `none` |

Right-column stack of full-bleed product shots on faint translucent plates, separated by 1px white-10% rules; captions sit beneath at 16px #8a8f98.

### Docs Sidebar Link (link)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#d0d6e0` |
| border | `none` |
| radius | `0` |
| padding | `6px 0` |
| font size | `14px` |
| font weight | `400` |
| shadow | `none` |
| hover | `color: #ffffff` |

Flat list, no indent markers or active bar; section headings ('Compare') use 14px/500 in #f7f8f8 with 24px of space above.

## Layout

Asymmetric split: a left content column (~68% on desktop, padded 32px) holding nav, hero, CTA and the feature list, and a right column of stacked screenshot panels that bleeds to the viewport edge. The hero deliberately leaves a large empty void between CTA and feature list — negative space is a feature. Docs switch to a three-zone layout: a 200px left nav list, a ~560px measure for prose, and generous right gutter, with a full-bleed ASCII mono band running across the top of the page. Content maxes out around 1200px; nothing is centred except within its own column.

## Imagery

Only product screenshots of the app itself, shown at native resolution inside 12px-radius translucent plates (white 6% fill, white 10% border) so dark app chrome dissolves into the page. No photography, no illustration, no icons beyond the Apple glyph. The one piece of ornament is a generated ASCII/glyph field in Departure Mono 12px rendered in dim greys with scattered #e17909 characters, used as a page-header texture.

## Motion

Near-static. Transitions limited to ~150ms background/border-colour fades on buttons, cards and links. The only animated element is the amber cursor bar beside the wordmark, which blinks like a text caret. No parallax, no scroll reveals, no transforms.

## Responsive

Below ~900px the two columns stack: the left content column goes full width with 32px side padding, and the screenshot panels fall beneath it as a full-bleed stack separated by 1px white-10% rules. Nav does not collapse into a hamburger — the wordmark, Docs, Updates and the GitHub pill stay on one row at 14–16px, just with tighter gaps. The H1 drops from 48px to about 32px while keeping -0.02em tracking and 1.1 line-height. The CTA stays intrinsic-width (never full-bleed) and keeps its 12px radius with the Beta badge and version wrapping onto the same row when space allows. Feature pairs stay inline but wrap their description onto a second line, so row rhythm loosens to ~40px. Docs sidebar moves above the article content as a plain list.

## Do

- Keep the ground at #121212 and build hierarchy by stepping to #303030/#323232 — never introduce a pure #000 or a mid-grey page background.
- Use white only for headlines, nav and feature labels; everything explanatory drops to #8a8f98 so pages read as two-tone.
- Hold #e17909 to tiny marks — the wordmark caret, a few ASCII glyphs, focus rings. It should total well under 1% of the page.
- Use -apple-system at 400/500 with -0.02em tracking on the 48px headline; let the system font do the work rather than a branded display face.
- Apply 12px radius to every rounded box (buttons, cards, screenshot plates) and 8px only to badges.
- Draw separation with 1px rgba(255,255,255,0.10) hairlines and translucent white fills rather than solid grey borders.
- Let large empty regions stand — the hero's vertical void between CTA and feature list is intentional.

## Don't

- Don't add box-shadows, glows or gradients; the measured system has zero shadows and depth comes only from surface value.
- Don't make the primary CTA amber or white — it is a #323232 grey slab with white label.
- Don't set body copy in Departure Mono; it is texture and metadata only, at 12px with 0.84px tracking.
- Don't sticky or blur the header — it is static, transparent and has no bottom border.
- Don't centre the hero or balance the columns; the asymmetric left-text / right-screenshot split is the signature.
- Don't substitute a geometric sans like Poppins or a heavy weight above 600 — SF's 400/500/590 range is the voice.
- Don't crop screenshots into rounded cards with heavy padding; they bleed edge-to-edge inside their faint plate.

## Agent prompt

> Build a dark, near-silent macOS-app marketing page: background #121212, body text #ffffff, secondary text #8a8f98, raised surfaces #303030 and #323232 with #3f3f3f hover, hairlines rgba(255,255,255,0.10) and translucent panel fills rgba(255,255,255,0.06); the single accent is amber #e17909 used only for a blinking caret beside the blackletter 'w' wordmark and a few highlighted glyphs. Type everything in -apple-system / BlinkMacSystemFont / SF Pro Display (fallback Inter) at weights 400/500/590 — hero H1 48px/1.0 weight 400 with -0.02em tracking, lead 17px/1.6, body 16px/1, UI and nav 14px/500, captions 12px, badges 10px/500 — and use ui-serif (New York/Georgia) at 48px/400 only for docs page titles, plus Departure Mono 12px with 0.84px tracking for ASCII header texture and version strings. Layout is an asymmetric split: left column (~68%, 32px padding) with a static transparent nav (wordmark, Docs, Updates, then a ghost GitHub pill with 1px rgba(255,255,255,0.14) border, 12px radius), the hero headline, a #323232 12px-radius CTA reading 'Download for MacOS' with an Apple glyph (12px 20px padding, 14px/500 white label, hover #3f3f3f), an 8px-radius #323232 'Beta' chip plus muted version number, a 12px #8a8f98 line of fine print, a large deliberate void, then inline feature pairs where a white 16px label is followed by a #8a8f98 description; the right column is a full-bleed stack of product screenshots on 12px-radius translucent plates separated by 1px white-10% rules. Spacing on a 4px grid with 20px as the default padding and 64px section gaps; radii 12px everywhere (8px for badges); absolutely no shadows, gradients, icons or illustration; transitions limited to 150ms colour fades. On mobile the columns stack full-width, the nav stays as one inline row (no hamburger), the H1 drops to ~32px and the CTA stays intrinsic width.

## CSS custom properties

```css
/* Writer — CSS custom properties. Generated from style.json */
:root {
  /* Palette */
  --color-bg: #121212; /* Page background on every route, including docs and mobile */
  --color-surface: #323232; /* Primary CTA fill, badge fill, raised chips */
  --color-surface-subtle: #303030; /* Doc cards and low-contrast panels on the ground */
  --color-surface-hover: #3f3f3f; /* Hover state for the primary button and cards */
  --color-text: #ffffff; /* Headline, nav links, feature labels, button labels */
  --color-text-strong: #f7f8f8; /* Docs H1 and card titles — a hair softer than pure white */
  --color-text-secondary: #d0d6e0; /* Docs body copy and sidebar links */
  --color-text-muted: #8a8f98; /* Feature descriptions, version number, captions, card body */
  --color-accent: #e17909; /* Logo cursor bar, ASCII header glyph highlights, link/focus accent */

  /* Semantic roles */
  --background: #121212;
  --surface: #303030;
  --surface-raised: #323232;
  --border: rgba(255,255,255,0.10);
  --text: #ffffff;
  --text-muted: #8a8f98;
  --primary: #323232;
  --primary-text: #ffffff;
  --accent: #e17909;
  --warning: #e17909;

  /* Typography */
  --font-body: -apple-system, BlinkMacSystemFont, 'SF Pro Display', system-ui, Inter, 'Segoe UI', sans-serif;
  --font-display: ui-serif, 'New York', Georgia, 'Times New Roman', serif;
  --font-mono: 'Departure Mono', ui-monospace, 'SF Mono', Menlo, monospace;
  --text-display-h1: 48px;
  --text-display-h1--line-height: 1;
  --text-display-h1--letter-spacing: -0.02em;
  --text-display-h1--font-weight: 400;
  --text-docs-h1-serif: 48px;
  --text-docs-h1-serif--line-height: 1;
  --text-docs-h1-serif--letter-spacing: 0;
  --text-docs-h1-serif--font-weight: 400;
  --text-card-title: 17px;
  --text-card-title--line-height: 1.4;
  --text-card-title--letter-spacing: -0.012em;
  --text-card-title--font-weight: 590;
  --text-lead: 17px;
  --text-lead--line-height: 1.6;
  --text-lead--letter-spacing: 0;
  --text-lead--font-weight: 400;
  --text-body: 16px;
  --text-body--line-height: 1;
  --text-body--letter-spacing: 0;
  --text-body--font-weight: 400;
  --text-small-ui: 14px;
  --text-small-ui--line-height: 1.5;
  --text-small-ui--letter-spacing: -0.013em;
  --text-small-ui--font-weight: 400;
  --text-nav-button: 14px;
  --text-nav-button--line-height: 1;
  --text-nav-button--letter-spacing: 0;
  --text-nav-button--font-weight: 500;
  --text-caption: 12px;
  --text-caption--line-height: 1;
  --text-caption--letter-spacing: 0;
  --text-caption--font-weight: 500;
  --text-mono-texture: 12px;
  --text-mono-texture--line-height: 1.25;
  --text-mono-texture--letter-spacing: 0.07em;
  --text-mono-texture--font-weight: 400;

  /* Spacing */
  --space-1: 2px;
  --space-2: 4px;
  --space-3: 8px;
  --space-4: 12px;
  --space-5: 20px;
  --space-6: 24px;
  --space-7: 32px;
  --space-8: 36px;
  --space-9: 64px;
  --container: 1200px;
  --section-gap: 64px;

  /* Radius */
  --radius-buttons-cards-screenshot-panels-nav-github-pill: 12px;
  --radius-badges-and-small-chips: 8px;
  --radius-hairline-dividers-full-bleed-panels: 0;

  /* Shadows */
  --shadow-none: none;
}
```

## Tailwind v4 theme

```css
/* Writer — Tailwind CSS v4 theme. Import after tailwindcss: @import "tailwindcss"; then paste this block. */
@theme {
  --color-bg: #121212;
  --color-surface: #323232;
  --color-surface-subtle: #303030;
  --color-surface-hover: #3f3f3f;
  --color-text: #ffffff;
  --color-text-strong: #f7f8f8;
  --color-text-secondary: #d0d6e0;
  --color-text-muted: #8a8f98;
  --color-accent: #e17909;
  --color-background: #121212;
  --color-surface: #303030;
  --color-surface-raised: #323232;
  --color-border: rgba(255,255,255,0.10);
  --color-text: #ffffff;
  --color-text-muted: #8a8f98;
  --color-primary: #323232;
  --color-primary-text: #ffffff;
  --color-accent: #e17909;
  --color-warning: #e17909;
  --font-body: -apple-system, BlinkMacSystemFont, 'SF Pro Display', system-ui, Inter, 'Segoe UI', sans-serif;
  --font-display: ui-serif, 'New York', Georgia, 'Times New Roman', serif;
  --font-mono: 'Departure Mono', ui-monospace, 'SF Mono', Menlo, monospace;
  --text-display-h1: 48px;
  --text-display-h1--line-height: 1;
  --text-display-h1--letter-spacing: -0.02em;
  --text-display-h1--font-weight: 400;
  --text-docs-h1-serif: 48px;
  --text-docs-h1-serif--line-height: 1;
  --text-docs-h1-serif--letter-spacing: 0;
  --text-docs-h1-serif--font-weight: 400;
  --text-card-title: 17px;
  --text-card-title--line-height: 1.4;
  --text-card-title--letter-spacing: -0.012em;
  --text-card-title--font-weight: 590;
  --text-lead: 17px;
  --text-lead--line-height: 1.6;
  --text-lead--letter-spacing: 0;
  --text-lead--font-weight: 400;
  --text-body: 16px;
  --text-body--line-height: 1;
  --text-body--letter-spacing: 0;
  --text-body--font-weight: 400;
  --text-small-ui: 14px;
  --text-small-ui--line-height: 1.5;
  --text-small-ui--letter-spacing: -0.013em;
  --text-small-ui--font-weight: 400;
  --text-nav-button: 14px;
  --text-nav-button--line-height: 1;
  --text-nav-button--letter-spacing: 0;
  --text-nav-button--font-weight: 500;
  --text-caption: 12px;
  --text-caption--line-height: 1;
  --text-caption--letter-spacing: 0;
  --text-caption--font-weight: 500;
  --text-mono-texture: 12px;
  --text-mono-texture--line-height: 1.25;
  --text-mono-texture--letter-spacing: 0.07em;
  --text-mono-texture--font-weight: 400;
  --radius-buttons-cards-screenshot-panels-nav-github-pill: 12px;
  --radius-badges-and-small-chips: 8px;
  --radius-hairline-dividers-full-bleed-panels: 0;
  --shadow-none: none;
  --container-site: 1200px;
}
```

## Theme tokens — light + dark

The shadcn-named layer DevDojo Sites speaks (`bg-background`, `text-foreground`, `bg-primary`, `rounded-medium`…). Paste into site.css after `@import "tailwindcss"` to restyle any site in this look.

```css
/* Writer — DevDojo theme tokens (light + dark). Generated from style.json. */
/* Drop into site.css after @import "tailwindcss": bg-background, text-foreground, bg-primary, border-border, rounded-medium… all read these. Dark mode: captured; the light half is estimated — the site is dark by default. Add class="dark" to <html> for the site's native look. */
@custom-variant dark (&:where(.dark, .dark *));

:root {
    color-scheme: light;

    --background: #f7f8f8;
    --foreground: #121212;
    --card: #ffffff;
    --card-foreground: #121212;
    --popover: #ffffff;
    --popover-foreground: #121212;
    --primary: #323232;
    --primary-foreground: #ffffff;
    --secondary: #e8eaed;
    --secondary-foreground: #303030;
    --muted: #e8eaed;
    --muted-foreground: #6b7079;
    --accent: #e17909;
    --accent-foreground: #ffffff;
    --destructive: #c23c1e;
    --destructive-foreground: #ffffff;
    --border: rgba(18,18,18,0.12);
    --input: rgba(18,18,18,0.16);
    --ring: #e17909;

    --radius-small: 8px;
    --radius-medium: 12px;
    --radius-large: 12px;
    --radius: var(--radius-medium);

    --font-body: -apple-system, BlinkMacSystemFont, 'SF Pro Display', system-ui, Inter, 'Segoe UI', sans-serif;
    --font-display: ui-serif, 'New York', Georgia, 'Times New Roman', serif;
    --font-mono: 'Departure Mono', ui-monospace, 'SF Mono', Menlo, monospace;
}

.dark {
    color-scheme: dark;

    --background: #121212;
    --foreground: #ffffff;
    --card: #303030;
    --card-foreground: #f7f8f8;
    --popover: #323232; /* estimated */
    --popover-foreground: #f7f8f8; /* estimated */
    --primary: #323232;
    --primary-foreground: #ffffff;
    --secondary: #303030;
    --secondary-foreground: #d0d6e0;
    --muted: #303030;
    --muted-foreground: #8a8f98;
    --accent: #e17909;
    --accent-foreground: #121212;
    --destructive: #e05a3a; /* estimated */
    --destructive-foreground: #ffffff; /* estimated */
    --border: rgba(255,255,255,0.10);
    --input: rgba(255,255,255,0.14); /* estimated */
    --ring: #e17909; /* estimated */
}

@theme inline {
    --color-background: var(--background);
    --color-foreground: var(--foreground);
    --color-card: var(--card);
    --color-card-foreground: var(--card-foreground);
    --color-popover: var(--popover);
    --color-popover-foreground: var(--popover-foreground);
    --color-primary: var(--primary);
    --color-primary-foreground: var(--primary-foreground);
    --color-secondary: var(--secondary);
    --color-secondary-foreground: var(--secondary-foreground);
    --color-muted: var(--muted);
    --color-muted-foreground: var(--muted-foreground);
    --color-accent: var(--accent);
    --color-accent-foreground: var(--accent-foreground);
    --color-destructive: var(--destructive);
    --color-destructive-foreground: var(--destructive-foreground);
    --color-border: var(--border);
    --color-input: var(--input);
    --color-ring: var(--ring);
    --radius-small: var(--radius-small);
    --radius-medium: var(--radius-medium);
    --radius-large: var(--radius-large);
    --font-body: var(--font-body);
    --font-display: var(--font-display);
    --font-mono: var(--font-mono);
}
```
