Make your AI a shadcn expert

Roam Research Design System

Roam Research's marketing system: near-monochrome charcoal and white with a single mid-blue voltage, Inter weight 500, and user testimony as the entire above-fold visual argument.

About Roam Research DESIGN.md

Curated by Dov AzencotUpdated Source roamresearch.com

  • Productivity & SaaS
  • Documentation & Knowledge

Roam Research's marketing page opens with no hero illustration, no gradient, and no product screenshot. The first thing a visitor reads is "A note taking tool for networked thought" in 36px Inter weight 500, followed immediately by a dense grid of user testimonials — six attributed paragraphs from researchers, writers, and academics describing what happened to their thinking after switching to Roam. This is a rare rhetorical choice: trust the testimony of the community entirely, rather than mediating the first impression through brand imagery. Where Notion uses carefully cropped product screenshots with friendly pastel color, and where Obsidian leads with the graph visualization as visual spectacle, Roam's above-fold experience is literary.

The DESIGN.md file packages the system into a machine-readable spec for React tooling. Inside: 12 color tokens built on a near-monochrome foundation — the dominant ink is an anonymous charcoal (#444444) appearing 178 times across text and borders, with the single mid-blue voltage (#137cbd, the Blueprint UI blue) appearing 20 times as links, CTA fills, and a gradient stop; 11 typography tokens running Inter across every tier from 44px display to 10.5px fine-print caption; 5 corner-radius tokens centered on a 3px minimum that gives the UI an archival-document feel; and 14 component definitions.

Feed this file to an AI coding tool and it reproduces Roam's specific moves: near-monochrome document aesthetic instead of SaaS color palette, Inter weight 500 as the structural weight rather than 700, Blueprint-blue as the sole interactive signal, and 3px corner rounding as the near-flat default. The one discipline worth studying here is the testimony-as-hero move — it only works for a product with an unusually fervent user base willing to articulate specific, technical, and personal ways the tool changed how they work.

What makes it distinct

  1. Testimony-as-herothe page leads with dense user quotes rather than a product screenshot or gradient illustration, trusting written endorsements to sell a writing tool
  2. Single mid-blue voltagethe Blueprint blue (#137cbd) appears 20 times as links, CTA buttons, pricing highlights, and the lone gradient; no secondary accent exists
  3. Inter weight 500 throughoutthe dominant weight is medium, not bold; even the 36px h1 sits at 500, a quietness that positions Roam as a thinking tool rather than a productivity dashboard
  4. Razor-thin radius scalethe dominant radius is 3px (9 instances), giving every card, button, and chip a near-flat document feel with only the slightest softening
  5. Serif insert in product screenshotsTimes New Roman appears in the embedded Roam app mockups, signaling that the editor is writing-first rather than structured-data-first

Live at roamresearch.com

A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.

Screenshot of Roam Research's website at roamresearch.comroamresearch.com

Explore Roam Research

Pick what you want to see — mockups, colors, typography, layout, or the full component list.

Brand & Accent

Sparing, CTA-only voltage.

Surface

Page and card backgrounds.

Text

Headlines, body, captions, muted.

Other

Specialty colors.

Roam Research design system FAQ

Common questions about Roam Research's tokens, components, and how to use this DESIGN.md in your project.

Specs, directories, and component libraries that pair with this design system.

Use Roam Research in your project

One machine-readable file. Drop it into Claude, Cursor, or any AI tool that reads DESIGN.md.

Download DESIGN.md