# Developer Platform: design brief

> Code first, precise, quietly technical.

Developer Platform is a website design language in the 04 Product & Brand (professional, business-ready) family of [Design Atlas by H190K](https://designatlas.h190k.com/). This brief describes how the reference mockup is built: theme tokens for light and dark, typography, shape, page structure and motion. The mockup demonstrates the style on Basalt, a serverless database platform with a global edge network and a typed API.

> [!IMPORTANT]
> **Concept mockup.** Basalt is a fictional brand: every name, person, figure and logo on the page is invented, and icons, illustrations, charts and small details are illustrative stand-ins. The mockup shows the direction of the Developer Platform style (mood, typography, colour, layout), not a finished design or template. Final client websites are designed from scratch around the client's own brand, content and goals.

## Quick links

- Live mockup (light & dark toggle): https://designatlas.h190k.com/designs/developer-platform/
- Light preview: https://designatlas.h190k.com/previews/developer-platform-light.jpg
- Dark preview: https://designatlas.h190k.com/previews/developer-platform-dark.jpg
- Social card: https://designatlas.h190k.com/og/developer-platform.jpg
- Design spec (JSON): https://designatlas.h190k.com/designs/developer-platform.json
- This brief (Markdown): https://designatlas.h190k.com/designs/developer-platform.md
- Request this design from H190K: https://designatlas.h190k.com/contact/?design=developer-platform
- Reference guide (URL patterns, schema): https://designatlas.h190k.com/agents.md

## At a glance

| | |
| --- | --- |
| Family | 04 Product & Brand (professional, business-ready) |
| Era | 2018 to now |
| Also known as | API-first, Docs-driven |
| Example brand (fictional) | Basalt, a serverless database platform with a global edge network and a typed API |
| Type | IBM Plex Sans (body) + JetBrains Mono Variable (mono) |
| Corners | rounded (~14px), with pill-shaped buttons/badges |
| Content width | 1240px |

## Description

Developer-platform design speaks in code: a hero with a real-looking code sample and terminal, language tabs, API reference snippets, architecture diagrams, status and latency figures, and usage-based pricing. Monospace accents and hairline grids signal engineering rigour.

## Signature traits (keep these)

- Code sample and terminal in the hero
- Language and framework tabs
- Hairline grid and monospace accents
- Architecture and request-flow diagrams
- Usage-based pricing and status figures
- Type pairing: IBM Plex Sans for headings and body, JetBrains Mono Variable for labels and data (or close equivalents)
- Corner language: rounded (~14px), with pill-shaped buttons/badges
- Depth style: 0 1px 2px rgba(9, 9, 11, 0.06), 0 30px 70px -24px rgba(30, 20, 90, 0.28)
- A clear accent role (--bs-accent: #5b4bff in light, #9d8cff in dark), used sparingly for CTAs and highlights
- Both a light and a dark theme driven by the same CSS custom-property names
- Content width around 1240px
- prefers-reduced-motion support for every animation

## Best for

- APIs and developer tools
- Cloud infrastructure and databases
- Open-source projects

## Colour

Theme switching: light tokens live on `:root`; dark values override them on `:root[data-theme='dark']` (the `<html>` element carries `data-theme="light"` or `"dark"`). Values below are resolved (any `var()` references expanded).

### Palette summary

| Role | Light | Dark |
| --- | --- | --- |
| Background | `#fafafa` (`--bs-bg`) | `#09090b` (`--bs-bg`) |
| Surface | `#ffffff` (`--bs-surface`) | `#141417` (`--bs-surface`) |
| Text | `#09090b` (`--bs-text`) | `#fafafa` (`--bs-text`) |
| Muted text | `#52525b` (`--bs-muted`) | `#a1a1aa` (`--bs-muted`) |
| Border / line | `#e4e4e7` (`--bs-line`) | `#26262b` (`--bs-line`) |
| Accent 1 | `#5b4bff` (`--bs-accent`) | `#9d8cff` (`--bs-accent`) |
| Accent 2 | `#0e6c4e` (`--bs-ok`) | `#3ddc97` (`--bs-ok`) |
| Accent 3 | `#b45309` (`--bs-warn`) | `#f5a524` (`--bs-warn`) |
| Accent 4 | `#c2342b` (`--bs-bad`) | `#ff6b5e` (`--bs-bad`) |
| Catalog swatch (bg / surface / accent) | `#fafafa` `#ffffff` `#5b4bff` | `#09090b` `#141417` `#9d8cff` |

### All theme tokens (44)

| Token | Light | Dark |
| --- | --- | --- |
| `--bs-bg` | `#fafafa` | `#09090b` |
| `--bs-surface` | `#ffffff` | `#141417` |
| `--bs-panel` | `#f4f4f5` | `#1b1b1f` |
| `--bs-line` | `#e4e4e7` | `#26262b` |
| `--bs-line-2` | `#d4d4d8` | `#34343b` |
| `--bs-text` | `#09090b` | `#fafafa` |
| `--bs-text-2` | `#27272a` | `#e4e4e7` |
| `--bs-muted` | `#52525b` | `#a1a1aa` |
| `--bs-faint` | `#6b6b74` | `#8c8c96` |
| `--bs-accent` | `#5b4bff` | `#9d8cff` |
| `--bs-accent-ink` | `#4636e8` | `#b3a6ff` |
| `--bs-accent-soft` | `rgba(91, 75, 255, 0.08)` | `rgba(157, 140, 255, 0.1)` |
| `--bs-on-accent` | `#ffffff` | `#0b0820` |
| `--bs-btn` | `#09090b` | `#fafafa` |
| `--bs-btn-ink` | `#fafafa` | `#09090b` |
| `--bs-ok` | `#0e6c4e` | `#3ddc97` |
| `--bs-warn` | `#b45309` | `#f5a524` |
| `--bs-bad` | `#c2342b` | `#ff6b5e` |
| `--bs-glow` | `rgba(91, 75, 255, 0.14)` | `rgba(140, 120, 255, 0.22)` |
| `--bs-shadow` | `0 1px 2px rgba(9, 9, 11, 0.05), 0 12px 32px -12px rgba(9, 9, 11, 0.14)` | `0 0 0 1px rgba(255, 255, 255, 0.02), 0 20px 40px -20px rgba(0, 0, 0, 0.8)` |
| `--bs-shadow-lg` | `0 1px 2px rgba(9, 9, 11, 0.06), 0 30px 70px -24px rgba(30, 20, 90, 0.28)` | `0 0 0 1px rgba(255, 255, 255, 0.04), 0 40px 90px -30px rgba(0, 0, 0, 0.9), 0 0 80px -30px rgba(140, 120, 255, 0.35)` |
| `--ed-bg` | `#ffffff` | `#0f0f12` |
| `--ed-gutter` | `#6b6b74` | `#8a8a94` |
| `--ed-hl` | `rgba(91, 75, 255, 0.07)` | `rgba(157, 140, 255, 0.09)` |
| `--ed-chrome` | `#f4f4f5` | `#141417` |
| `--syn-kw` | `#7a3bd9` | `#c4a7ff` |
| `--syn-str` | `#07673f` | `#7ee2b8` |
| `--syn-fn` | `#0b5fc2` | `#82b8ff` |
| `--syn-num` | `#b4540a` | `#ffb86b` |
| `--syn-com` | `#6e6e78` | `#8b8b95` |
| `--syn-ty` | `#0b6379` | `#5fd3e6` |
| `--syn-p` | `#3f3f46` | `#a1a1aa` |
| `--syn-id` | `#18181b` | `#e4e4e7` |
| `--col-top` | `#ffffff` | `#232329` |
| `--col-l` | `#ececf1` | `#18181c` |
| `--col-m` | `#e0e0e7` | `#121215` |
| `--col-r` | `#cfcfd8` | `#0c0c0e` |
| `--col-edge` | `rgba(9, 9, 11, 0.09)` | `rgba(255, 255, 255, 0.06)` |
| `--col-glow-1` | `#8b7dff` | `#b9adff` |
| `--col-glow-2` | `#5b4bff` | `#7b68ff` |
| `--tag-bg` | `#09090b` | `#fafafa` |
| `--tag-ink` | `#fafafa` | `#09090b` |
| `--map-land` | `#d4d4d8` | `#2e2e35` |
| `--grid` | `rgba(9, 9, 11, 0.045)` | `rgba(255, 255, 255, 0.035)` |

## Typography

| Family | Role | Uses | Package | CSS stack |
| --- | --- | --- | --- | --- |
| JetBrains Mono Variable | mono | 52 | `@fontsource-variable/jetbrains-mono` (variable) | `'JetBrains Mono Variable', monospace` |
| IBM Plex Sans | body | 3 | `@fontsource/ibm-plex-sans` (400, 500, 600, 700) | `'IBM Plex Sans', sans-serif` |

Font packages (self-hosted via Fontsource): `@fontsource/ibm-plex-sans`, `@fontsource-variable/jetbrains-mono`.

Type scale (from the CSS, light theme):

| Element | Size | Weight | Line height | Letter spacing | Other |
| --- | --- | --- | --- | --- | --- |
| h1 | `clamp(40px, 4.4vw, 58px)` | `600` | `1.02` | `-0.035em` | font-style: normal |
| h2 | `clamp(30px, 4vw, 52px)` | `600` | `1.08` | `-0.025em` | – |
| h3 | `19px` | `600` | – | `0.08em` | text-transform: uppercase; font: 600 11.5px 'JetBrains Mono Variable', monospace |

## Shape and depth

- **Corner style:** rounded (~14px), with pill-shaped buttons/badges
- **Border radii (most common first):** `50%`, `14px`, `8px`, `12px`, `4px`, `10px`, `6px`, `2px`, `999px`, `1px`
- **Shadows (most common first; `var()` names are custom properties of the mockup, mostly the theme tokens above):**
  - `0 1px 2px rgba(9, 9, 11, 0.06), 0 30px 70px -24px rgba(30, 20, 90, 0.28)`
  - `inset 2px 0 0 var(--bs-accent)`
  - `0 0 0 1px var(--bs-accent), var(--bs-shadow-lg)`
  - `0 0 0 3px color-mix(in srgb, var(--bs-ok) 22%, transparent)`
  - `0 1px 2px rgba(0, 0, 0, 0.06)`
  - `0 1px 2px rgba(9, 9, 11, 0.05), 0 12px 32px -12px rgba(9, 9, 11, 0.14)`
- **Borders (most common first):**
  - `border-bottom: 1px solid var(--bs-line)`
  - `1px solid var(--bs-line)`
  - `border-right: 1px solid var(--bs-line)`
  - `1px solid var(--bs-line-2)`
  - `border-top: 1px solid var(--bs-line)`
  - `1px solid #2a2a30`
- **Visual effects used:** linear-gradient (6), backdrop-filter blur (2), mask-image (2), radial-gradient (2), filter (drop-shadow/blur) (1), inline SVG illustration (1)

## Page structure

- **Content width:** 1240px (`.frame { width: min(1240px, 100% - 48px) }`)
- **Breakpoints:** 1120px, 720px
- **Main navigation:** Product · Docs · Pricing · Changelog · Customers · Blog
- **H1 in the mockup:** “The database that runs where your users are.” (fictional copy, replace it)

Heading outline of the mockup, in order (h1/h2, with h3s beneath). Use it for rhythm and section types, not as copy:

1. **[H1]** The database that runs where your users are.
2. Follow a query around the world in 4 ms.
3. Everything a database should do, nothing you have to babysit.
   - Branch per pull request · Schemas as types · Point-in-time restore · Vector search · Row-level security · Realtime streams
4. A small, boring, versioned HTTP API.
   - Run a query
5. 38 regions. Every user is close to one.
6. Pay for rows, not for servers.
   - Hobby · Pro Most teams · Enterprise
7. Boringly up.
8. Shipped this month.
   - Branching for every pull request · Vector indexes are generally available · Faster cold starts in sin1 and syd1 · Rust client 1.0
9. From zero to a global database in one command.
   - Product · Developers · Company · Trust

Top-level page blocks (landmarks in DOM order):

| # | Element | Class | Label / heading |
| --- | --- | --- | --- |
| 1 | header | `nav` | – |
| 2 | section | `hero` | The database that runs where your users are. |
| 3 | section | `logos` | Customers |
| 4 | section | `flow` | Follow a query around the world in 4 ms. |
| 5 | section | `features` | Everything a database should do, nothing you have to babysit. |
| 6 | section | `api` | A small, boring, versioned HTTP API. |
| 7 | section | `edge` | 38 regions. Every user is close to one. |
| 8 | section | `pricing` | Pay for rows, not for servers. |
| 9 | section | `status` | Boringly up. |
| 10 | section | `changelog` | Shipped this month. |
| 11 | section | `quotes` | What engineers say |
| 12 | section | `cta` | From zero to a global database in one command. |
| 13 | footer | `footer` | Product |

## Motion

- **Marquee / ticker:** no
- **Keyframe animations:** `bs-blink`, `bs-flow`, `bs-ev`
- **CSS transitions:** 3
- **Client-side script (interactions / scripted motion):** yes
- **Respects prefers-reduced-motion:** yes

## Keep vs. replace

The mockup is a concept for Basalt, a fictional brand. The design language (tokens, type, shape, rhythm, motion) is the reusable part; its name, copy, figures, people, logos, icons and illustrations are not.

**Design language (the signature traits above, plus):**

- The colour roles and their light/dark relationship (palette summary above)
- The type pairing: IBM Plex Sans for headings and body, JetBrains Mono Variable for labels and data
- The shape language: radii, shadow recipe, border weights and visual effects
- The page rhythm and density, and the motion character

**Brand-specific (replace for a real brand):**

- The fictional brand name, logo and logo mark
- All copy: headlines, body text, navigation labels, testimonials, FAQs, legal text
- All figures, prices, statistics, dates, locations and people
- Illustrations, icons, charts and imagery (they are illustrative stand-ins; commission or create originals for the client)
- Logo walls and partner names (invented companies)
- Colours, where the client already has brand colours: map them onto the same token roles (background, surface, text, muted, accent) and re-check contrast in both themes
- Section order and count, to match the client’s real content and goals

---

Part of [Design Atlas by H190K](https://designatlas.h190k.com/), a catalog of website design languages by Hasan Albehadili (H190K). Catalog index: https://designatlas.h190k.com/designs/index.json · Reference guide: https://designatlas.h190k.com/agents.md · LLM context: https://designatlas.h190k.com/llms.txt, https://designatlas.h190k.com/llms-full.txt. Generated 2026-11-16T02:13:46.191Z.
