# Ghostty — Design Reference
> ascii ghost in a quiet void

**Source:** https://ghostty.org  
**Theme:** dark  
**Category:** Developer Tools  
**Mood:** dark, technical, minimal, precise, monochrome  
**Captured:** 2026-11-21

## Overview

A near-black developer site that behaves like a terminal window pinned to an empty desk. The whole home page is one centred faux-macOS window frame filled with an ASCII-art ghost rendered in JetBrains Mono at 10px, flanked by a single grey sentence and two small outlined buttons. Nothing competes: no gradients, no imagery, no shadows — just a 1px hairline grid, a precise electric blue, and a lot of #0f0f11.

Technically it is achieved with a strict nine-step grey ramp (--gray-0 #0f0f11 through --gray-9 #f0f0f4) carrying every surface, border and text tone, one brand hue (#3551f3) reserved for the active nav item and the primary CTA outline, and a two-family type system: Pretendard Std Variable at 300–500 for all UI and prose, JetBrains Mono for ASCII art and keycaps. Radii are tiny (5–6px on controls, 10–12px on windows and cards), paddings cluster on a 6px rhythm, shadows are essentially absent, and the docs layout is a fixed 72px sticky bar over a left sidebar and a ~1300px content column.

## Tokens — Colors

| Name | Value | Token | Role |
|---|---|---|---|
| Void | `#0f0f11` | `--color-gray-0` | Page ground for every view; also the sticky nav fill so the bar dissolves into the page |
| Terminal Pane | `#16161a` | `--color-gray-1` | Raised surface: inside of the faux terminal window, search field, doc cards |
| Hairline | `#242428` | `--color-gray-2` | Default 1px border — nav bottom rule, card outlines, section dividers, sidebar edge |
| Window Edge | `#4c4c50` | `--color-gray-3` | Stronger 1px outline on the terminal window frame and secondary buttons |
| Dim Label | `#828286` | `--color-gray-4` | Tertiary text: window title, inactive sidebar links, placeholder copy |
| Grey Prose | `#959597` | `--color-gray-5` | Muted body copy and the hero description line |
| Read Text | `#c3c3c4` | `--color-gray-6` | Dominant body/UI text colour across docs and buttons |
| Headline White | `#f0f0f4` | `--color-gray-9` | Headings, nav links, logo wordmark — the brightest step |
| Signal Blue | `#3551f3` | `--color-brand-color` | Primary CTA outline, active sidebar item fill, focus/selection — the only chromatic UI colour |
| Traffic Red | `#ff605c` | `--color-mac-close` | Close dot on the faux window chrome only |
| Traffic Amber | `#ffbd44` | `--color-mac-minimize` | Minimize dot on the faux window chrome only |
| Traffic Green | `#00ca4e` | `--color-mac-zoom` | Zoom dot on the faux window chrome only |

### Semantic roles

| Role | Value |
|---|---|
| background | `#0f0f11` |
| surface | `#16161a` |
| surface raised | `#16161a` |
| border | `#242428` |
| text | `#f0f0f4` |
| text muted | `#959597` |
| primary | `#3551f3` |
| primary text | `#ffffff` |
| accent | `#3551f3` |
| success | `#00ca4e` |
| warning | `#ffbd44` |
| danger | `#ff605c` |

## Tokens — Typography

- **Body:** Pretendard Std Variable (300, 400, 500) — fallbacks: Pretendard, Inter, -apple-system, Segoe UI, sans-serif. Carries everything non-terminal: headings at 500, UI at 400, long prose at 300. Neutral grotesque with tall x-height; never goes above 500.
- **Mono:** JetBrains Mono (400) — fallbacks: SFMono-Regular, Menlo, Consolas, monospace. Used for the ASCII-art hero (10px, line-height normal) and keyboard shortcut chips (11px). Single weight only.

| Role | Size | Line height | Weight | Letter spacing | Family |
|---|---|---|---|---|---|
| H1 | 35px | 1.2 | 500 | normal | body |
| H2 | 25px | 1.2 | 500 | normal | body |
| H3 | 18px | 1.2 | 500 | normal | body |
| H4 / Card title | 16px | 1.2 | 500 | normal | body |
| Lead | 16px | 1.4 | 400 | normal | body |
| Body | 16px | 1.6 | 400 | normal | body |
| Body Light | 16px | 1.4 | 300 | normal | body |
| Small / UI | 14px | 1.4 | 300 | normal | body |
| Mono ASCII / Kbd | 10px–11px | normal | 400 | normal | mono |

## Tokens — Spacing & Layout

- **Base unit:** 6px
- **Density:** comfortable
- **Container max width:** 1300px
- **Section gap:** 40px
- **Card padding:** 20px
- **Scale:** 2px, 6px, 10px, 12px, 20px, 24px, 30px, 34px, 40px, 48px

## Tokens — Radius

| Element | Value |
|---|---|
| Button / small control | 5px |
| Input, search field, kbd chip | 6px |
| Doc card | 9px |
| Terminal window frame | 10px |
| Large panel | 12px |

## Tokens — Shadows

| Name | Value | Usage |
|---|---|---|
| form | `0 1px 2px 0 #37373726` | Only shadow in the system — a barely-there lift on form controls; everything else is flat. |

## Components

### Primary button (Download) (button)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#f0f0f4` |
| border | `1px solid #3551f3` |
| radius | `5px` |
| padding | `12px 20px` |
| font size | `16px` |
| font weight | `500` |
| shadow | `none` |
| hover | `background: rgba(53,81,243,0.12); border-color #3551f3` |

Primary is an outline, not a fill — the blue stroke is the whole signal. Height ~40px, label centred, never full-bleed on desktop.

### Secondary button (Documentation) (button)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#c3c3c4` |
| border | `1px solid #4c4c50` |
| radius | `5px` |
| padding | `12px 20px` |
| font size | `16px` |
| font weight | `500` |
| shadow | `none` |
| hover | `border-color: #828286; color: #f0f0f4` |

Identical geometry to primary; only the border and text step down the grey ramp. Pairs sit side by side with a 20px gap.

### Nav bar (nav)

| Property | Value |
|---|---|
| background | `#0f0f11` |
| color | `#f0f0f4` |
| border | `0 0 1px 0 solid #242428` |
| radius | `0` |
| padding | `0 24px` |
| font size | `16px` |
| font weight | `400` |
| shadow | `none` |
| hover | `color: #ffffff` |

Sticky, 72px tall, no backdrop blur. Left: ghost mark + wordmark. Right: 6px-radius search field, three text links (external ones carry a small arrow glyph), then the blue-outlined Download button.

### Search field (input)

| Property | Value |
|---|---|
| background | `#16161a` |
| color | `#828286` |
| border | `1px solid #242428` |
| radius | `6px` |
| padding | `7px 10px` |
| font size | `14px` |
| font weight | `400` |
| shadow | `0 1px 2px 0 #37373726` |
| hover | `border-color: #4c4c50` |

Leading magnifier icon, 'Search docs' placeholder, trailing kbd chip ('Ctrl K') in JetBrains Mono 11px on a #242428 pill with 4px radius.

### Doc card (card)

| Property | Value |
|---|---|
| background | `#0f0f11` |
| color | `#c3c3c4` |
| border | `1px solid #242428` |
| radius | `9px` |
| padding | `20px` |
| font size | `16px` |
| font weight | `300` |
| shadow | `none` |
| hover | `border-color: #4c4c50` |

Two-up grid with a 20px gap; 16px/500 title in #f0f0f4 above 300-weight grey description at 1.4 line-height. Flat — no fill change, no shadow.

### Sidebar item (link)

| Property | Value |
|---|---|
| background | `transparent` |
| color | `#c3c3c4` |
| border | `none` |
| radius | `5px` |
| padding | `12px 6px` |
| font size | `16px` |
| font weight | `500` |
| shadow | `none` |
| hover | `color: #f0f0f4` |

Active item inverts to a solid #3551f3 fill with #ffffff label and 5px radius. Collapsible groups carry a right-aligned chevron in #828286.

### Terminal window frame (other)

| Property | Value |
|---|---|
| background | `#0f0f11` |
| color | `#828286` |
| border | `1px solid #4c4c50` |
| radius | `10px` |
| padding | `34px 30px` |
| font size | `14px` |
| font weight | `300` |
| shadow | `none` |
| hover | `none` |

Hero container: three 12px traffic-light dots (#ff605c / #ffbd44 / #00ca4e) top-left with 8px gaps, centred '👻 Ghostty' title at 14px/300, ASCII art body in JetBrains Mono 10px tinted blue-to-white.

## Layout

Single centred column on a 1300px max width. The home page is one hero block: terminal window (~830px wide, ~590px tall) centred with 40px below it to the description line, then 20px to the button row — no sections below the fold, no footer chrome competing. Docs use a three-zone shell: 72px sticky top bar with a #242428 bottom rule, a ~266px left sidebar separated by a 1px vertical hairline, and a content column capped around 625px for readable measure, separated into sections by full-width 1px #242428 rules with ~48px of air either side.

## Imagery

No photography, no illustration, no gradients. The only 'image' is generative ASCII art: the Ghostty mark drawn in JetBrains Mono 10px glyphs, coloured in a gradient from #3551f3 at the silhouette edges to greys/whites in the body mass. Icons are thin monochrome line glyphs (magnifier, chevron, external-link arrow) in #828286. The ghost logo mark is a small rounded white badge in the nav.

## Motion

Near-static. Transitions are limited to 150ms colour/border fades on links, buttons and sidebar items; sidebar groups expand with a short height animation. The ASCII hero may re-render character-by-character but nothing parallaxes, scales or bounces.

## Responsive

Below ~900px the layout collapses to a single stacked column with roughly 20px side gutters. The docs sidebar disappears behind a hamburger that opens a full-width drawer using the same #0f0f11 ground and blue active-fill items; the search field shrinks to an icon-only button and the kbd chip is dropped. On the home page the terminal window keeps its 10px radius and 1px #4c4c50 outline but shrinks to the viewport width, the ASCII art rescales to a smaller monospace size so the ghost stays intact rather than cropping, and the hero copy wraps to three centred lines at 16px/1.4 in #959597. The two buttons stay side by side but grow to equal flexible widths with a larger ~18px vertical padding, giving ~56px tall tap targets; vertical rhythm loosens to ~40px between hero blocks.

## Do

- Keep #0f0f11 as the only page ground — let surfaces differ by 1px hairlines (#242428) rather than fills.
- Use #3551f3 sparingly: one outlined CTA, one active sidebar item, focus rings. Nothing else is coloured.
- Set long prose at 300 weight and headings at 500 in Pretendard; never reach for 600 or 700.
- Reserve JetBrains Mono for ASCII art, code and keycaps — never for headings or button labels.
- Keep radii small and consistent: 5–6px on controls, 9–12px on windows and cards.
- Build hierarchy with the grey ramp (#828286 → #959597 → #c3c3c4 → #f0f0f4), not with size jumps.

## Don't

- Don't add drop shadows, glows or glass blur — the system has exactly one 1px form shadow.
- Don't fill the primary button with brand blue; its identity is the blue outline on transparent.
- Don't introduce gradients, photos or stock illustration in place of the ASCII artwork.
- Don't use the traffic-light colours (#ff605c, #ffbd44, #00ca4e) anywhere except faux window chrome.
- Don't exceed 35px for H1 or let headings run uppercase or letter-spaced.
- Don't widen the docs text column past ~640px or let content run edge-to-edge at 1300px.

## Agent prompt

> Build a dark developer-tool site that reads like a terminal window on an empty desk. Ground everything in #0f0f11; raised surfaces #16161a; hairline borders #242428 with a stronger #4c4c50 on window frames and secondary buttons. Text ramp: #f0f0f4 headings/nav, #c3c3c4 UI and body, #959597 muted prose, #828286 placeholders and icons. One brand colour, #3551f3, used only for the primary CTA's 1px outline, the solid active sidebar pill (white label) and focus rings. Type: Pretendard Std Variable (fallback Inter) for everything — H1 35px/1.2/500, H2 25px/1.2/500, H3 18px/1.2/500, card titles 16px/1.2/500, body 16px/1.4–1.6 at 300–400, small 14px/300, no letter-spacing, no weight above 500; JetBrains Mono 400 only for ASCII art (10px) and kbd chips (11px). Spacing on a 6px unit (6/10/12/20/24/30/34/40/48), 1300px container, 20px card padding, 40px section gaps; docs text column ~625px. Radii: 5px buttons, 6px inputs, 9px cards, 10–12px window panels. Shadows: none, except 0 1px 2px #37373726 on form controls. Components: both hero buttons are transparent with 1px borders (blue #3551f3 for primary, #4c4c50 for secondary), 12px 20px padding, 16px/500, 5px radius, ~40px tall, 20px gap; 72px sticky nav on #0f0f11 with a 1px #242428 bottom rule, logo mark + wordmark left, a #16161a 6px-radius search field with a 'Ctrl K' mono chip plus three 16px/400 links and the Download button right; flat bordered doc cards in a two-up grid. Hero imagery is ASCII art of the product mark in monospace, tinted #3551f3 at the edges to white in the mass, inside a faux macOS window with #ff605c/#ffbd44/#00ca4e traffic dots. Motion is limited to 150ms colour fades. Overall: monochrome, hairline-precise, zero decoration.

## CSS custom properties

```css
/* Ghostty — CSS custom properties. Generated from style.json */
:root {
  /* Palette */
  --color-gray-0: #0f0f11; /* Page ground for every view; also the sticky nav fill so the bar dissolves into the page */
  --color-gray-1: #16161a; /* Raised surface: inside of the faux terminal window, search field, doc cards */
  --color-gray-2: #242428; /* Default 1px border — nav bottom rule, card outlines, section dividers, sidebar edge */
  --color-gray-3: #4c4c50; /* Stronger 1px outline on the terminal window frame and secondary buttons */
  --color-gray-4: #828286; /* Tertiary text: window title, inactive sidebar links, placeholder copy */
  --color-gray-5: #959597; /* Muted body copy and the hero description line */
  --color-gray-6: #c3c3c4; /* Dominant body/UI text colour across docs and buttons */
  --color-gray-9: #f0f0f4; /* Headings, nav links, logo wordmark — the brightest step */
  --color-brand-color: #3551f3; /* Primary CTA outline, active sidebar item fill, focus/selection — the only chromatic UI colour */
  --color-mac-close: #ff605c; /* Close dot on the faux window chrome only */
  --color-mac-minimize: #ffbd44; /* Minimize dot on the faux window chrome only */
  --color-mac-zoom: #00ca4e; /* Zoom dot on the faux window chrome only */

  /* Semantic roles */
  --background: #0f0f11;
  --surface: #16161a;
  --surface-raised: #16161a;
  --border: #242428;
  --text: #f0f0f4;
  --text-muted: #959597;
  --primary: #3551f3;
  --primary-text: #ffffff;
  --accent: #3551f3;
  --success: #00ca4e;
  --warning: #ffbd44;
  --danger: #ff605c;

  /* Typography */
  --font-body: 'Pretendard Std Variable', Pretendard, Inter, -apple-system, 'Segoe UI', sans-serif;
  --font-mono: 'JetBrains Mono', SFMono-Regular, Menlo, Consolas, monospace;
  --text-h1: 35px;
  --text-h1--line-height: 1.2;
  --text-h1--letter-spacing: normal;
  --text-h1--font-weight: 500;
  --text-h2: 25px;
  --text-h2--line-height: 1.2;
  --text-h2--letter-spacing: normal;
  --text-h2--font-weight: 500;
  --text-h3: 18px;
  --text-h3--line-height: 1.2;
  --text-h3--letter-spacing: normal;
  --text-h3--font-weight: 500;
  --text-h4-card-title: 16px;
  --text-h4-card-title--line-height: 1.2;
  --text-h4-card-title--letter-spacing: normal;
  --text-h4-card-title--font-weight: 500;
  --text-lead: 16px;
  --text-lead--line-height: 1.4;
  --text-lead--letter-spacing: normal;
  --text-lead--font-weight: 400;
  --text-body: 16px;
  --text-body--line-height: 1.6;
  --text-body--letter-spacing: normal;
  --text-body--font-weight: 400;
  --text-body-light: 16px;
  --text-body-light--line-height: 1.4;
  --text-body-light--letter-spacing: normal;
  --text-body-light--font-weight: 300;
  --text-small-ui: 14px;
  --text-small-ui--line-height: 1.4;
  --text-small-ui--letter-spacing: normal;
  --text-small-ui--font-weight: 300;
  --text-mono-ascii-kbd: 10px–11px;
  --text-mono-ascii-kbd--line-height: normal;
  --text-mono-ascii-kbd--letter-spacing: normal;
  --text-mono-ascii-kbd--font-weight: 400;

  /* Spacing */
  --space-1: 2px;
  --space-2: 6px;
  --space-3: 10px;
  --space-4: 12px;
  --space-5: 20px;
  --space-6: 24px;
  --space-7: 30px;
  --space-8: 34px;
  --space-9: 40px;
  --space-10: 48px;
  --container: 1300px;
  --section-gap: 40px;

  /* Radius */
  --radius-button-small-control: 5px;
  --radius-input-search-field-kbd-chip: 6px;
  --radius-doc-card: 9px;
  --radius-terminal-window-frame: 10px;
  --radius-large-panel: 12px;

  /* Shadows */
  --shadow-form: 0 1px 2px 0 #37373726;
}
```

## Tailwind v4 theme

```css
/* Ghostty — Tailwind CSS v4 theme. Import after tailwindcss: @import "tailwindcss"; then paste this block. */
@theme {
  --color-gray-0: #0f0f11;
  --color-gray-1: #16161a;
  --color-gray-2: #242428;
  --color-gray-3: #4c4c50;
  --color-gray-4: #828286;
  --color-gray-5: #959597;
  --color-gray-6: #c3c3c4;
  --color-gray-9: #f0f0f4;
  --color-brand-color: #3551f3;
  --color-mac-close: #ff605c;
  --color-mac-minimize: #ffbd44;
  --color-mac-zoom: #00ca4e;
  --color-background: #0f0f11;
  --color-surface: #16161a;
  --color-surface-raised: #16161a;
  --color-border: #242428;
  --color-text: #f0f0f4;
  --color-text-muted: #959597;
  --color-primary: #3551f3;
  --color-primary-text: #ffffff;
  --color-accent: #3551f3;
  --color-success: #00ca4e;
  --color-warning: #ffbd44;
  --color-danger: #ff605c;
  --font-body: 'Pretendard Std Variable', Pretendard, Inter, -apple-system, 'Segoe UI', sans-serif;
  --font-mono: 'JetBrains Mono', SFMono-Regular, Menlo, Consolas, monospace;
  --text-h1: 35px;
  --text-h1--line-height: 1.2;
  --text-h1--letter-spacing: normal;
  --text-h1--font-weight: 500;
  --text-h2: 25px;
  --text-h2--line-height: 1.2;
  --text-h2--letter-spacing: normal;
  --text-h2--font-weight: 500;
  --text-h3: 18px;
  --text-h3--line-height: 1.2;
  --text-h3--letter-spacing: normal;
  --text-h3--font-weight: 500;
  --text-h4-card-title: 16px;
  --text-h4-card-title--line-height: 1.2;
  --text-h4-card-title--letter-spacing: normal;
  --text-h4-card-title--font-weight: 500;
  --text-lead: 16px;
  --text-lead--line-height: 1.4;
  --text-lead--letter-spacing: normal;
  --text-lead--font-weight: 400;
  --text-body: 16px;
  --text-body--line-height: 1.6;
  --text-body--letter-spacing: normal;
  --text-body--font-weight: 400;
  --text-body-light: 16px;
  --text-body-light--line-height: 1.4;
  --text-body-light--letter-spacing: normal;
  --text-body-light--font-weight: 300;
  --text-small-ui: 14px;
  --text-small-ui--line-height: 1.4;
  --text-small-ui--letter-spacing: normal;
  --text-small-ui--font-weight: 300;
  --text-mono-ascii-kbd: 10px–11px;
  --text-mono-ascii-kbd--line-height: normal;
  --text-mono-ascii-kbd--letter-spacing: normal;
  --text-mono-ascii-kbd--font-weight: 400;
  --radius-button-small-control: 5px;
  --radius-input-search-field-kbd-chip: 6px;
  --radius-doc-card: 9px;
  --radius-terminal-window-frame: 10px;
  --radius-large-panel: 12px;
  --shadow-form: 0 1px 2px 0 #37373726;
  --container-site: 1300px;
}
```

## 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
/* Ghostty — 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: #ffffff;
    --foreground: #0f0f11;
    --card: #f0f0f4;
    --card-foreground: #0f0f11;
    --popover: #ffffff;
    --popover-foreground: #0f0f11;
    --primary: #3551f3;
    --primary-foreground: #ffffff;
    --secondary: #eaeaeb;
    --secondary-foreground: #16161a;
    --muted: #f0f0f4;
    --muted-foreground: #4c4c50;
    --accent: #e3e7fe;
    --accent-foreground: #3551f3;
    --destructive: #ff605c;
    --destructive-foreground: #ffffff;
    --border: #dbdbdc;
    --input: #dbdbdc;
    --ring: #3551f3;

    --radius-small: 5px;
    --radius-medium: 6px;
    --radius-large: 10px;
    --radius: var(--radius-medium);

    --font-body: 'Pretendard Std Variable', Pretendard, Inter, -apple-system, 'Segoe UI', sans-serif;
    --font-mono: 'JetBrains Mono', SFMono-Regular, Menlo, Consolas, monospace;
}

.dark {
    color-scheme: dark;

    --background: #0f0f11;
    --foreground: #f0f0f4;
    --card: #16161a;
    --card-foreground: #c3c3c4;
    --popover: #16161a; /* estimated */
    --popover-foreground: #f0f0f4; /* estimated */
    --primary: #3551f3;
    --primary-foreground: #ffffff;
    --secondary: #16161a;
    --secondary-foreground: #c3c3c4;
    --muted: #242428;
    --muted-foreground: #959597;
    --accent: #242428; /* estimated */
    --accent-foreground: #f0f0f4; /* estimated */
    --destructive: #ff605c;
    --destructive-foreground: #0f0f11; /* estimated */
    --border: #242428;
    --input: #242428;
    --ring: #3551f3; /* 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-mono: var(--font-mono);
}
```
