Make your AI a shadcn expert

Railway Design System

Railway's design language as a DESIGN.md file.

About Railway DESIGN.md

Curated by Dov AzencotUpdated Source railway.com

  • Web Infrastructure & Hosting
  • Developer Tools & IDEs

Railway's marketing page is what happens when a developer-cloud brand decides the right reference is not a dashboard mockup and not a launchpad illustration but a calm, mostly-empty stage. The canvas is "#13111c", an indigo-midnight so dark it reads as black until you put it next to actual black and watch it tilt violet. The hero headline is set in IBM Plex Serif at 54px / weight 500 / "-1.96px" tracking and reads "Ship software peacefully" — a serif on a dark page on a developer cloud, three decisions that almost no infrastructure brand makes together. Behind the headline sits a layered hero gradient (violet "#3d2259" / pink "#291839" / a far blue) that operates as theatre lighting rather than decoration. Everything else on the page — body paragraphs, nav links, button labels, footer rows — runs Inter at modest weights on the same indigo canvas.

This DESIGN.md packages the system into one machine-readable file following the Google Labs spec. Inside: 22 color tokens (the "#13111c" canvas, the "#f7f7f8" near-white text with 1165 occurrences, the "#33323e" hairline border with 1049 occurrences, the single muted-violet "#553f83" CTA, the brand green "#42946e" reserved for status indicators, plus the layered hero gradient stops "#3d2259" / "#291839" / "#180d43"), 11 typography tokens across IBM Plex Serif, Inter, Inter Tight, and JetBrains Mono, 5 radii from 4px to 9999px built around a 4px base (the 4px corner counts 439 times on the page), 9 spacing values from 2px to 64px, and 17 components covering the violet pill, the white-on-dark ghost button, the framed deploy mockup, the nav row, and the surface-elevated card.

Feed the file to Claude, Cursor, or Copilot when you want a React surface that reads as Railway — indigo canvas, serif headlines on dark, "#33323e" hairlines everywhere, a single muted-violet conversion target. Where most developer-cloud brands signal velocity with weight 600 sans, pure black canvases, and saturated electric accents, Railway signals it by lowering the voltage: a serif at weight 500, an indigo-not-black canvas, a violet CTA dialed two steps toward gray, and a hairline that lets the page read as one continuous surface rather than a stack of cards.

What makes it distinct

  1. Indigo-midnight canvas'#13111c' carries the entire page; no light surfaces, no polarity flips, no marketing white bands
  2. Serif hero on darkIBM Plex Serif at weight 500 with '-1.96px' tracking is the voice; Inter handles everything else
  3. Single muted-violet CTA'#553f83' fills one pill at 8px radius and never repeats as a fill anywhere else on the page
  4. Hairline as the entire structure'#33323e' draws 1049 of the page's borders, the highest-frequency color on the surface
  5. Hero gradient as theatre lightingviolet '#3d2259' / pink '#291839' layered behind the serif headline, never repeated as swatches

Live at railway.com

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

Screenshot of Railway's website at railway.comrailway.com

Explore Railway

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.

Borders & Hairlines

Dividers, outlines, structural rules.

Semantic

Status, errors, success, inline links.

Other

Specialty colors.

Railway design system FAQ

Common questions about Railway'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 Railway in your project

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

Download DESIGN.md