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
- Indigo-midnight canvas'#13111c' carries the entire page; no light surfaces, no polarity flips, no marketing white bands
- Serif hero on darkIBM Plex Serif at weight 500 with '-1.96px' tracking is the voice; Inter handles everything else
- Single muted-violet CTA'#553f83' fills one pill at 8px radius and never repeats as a fill anywhere else on the page
- Hairline as the entire structure'#33323e' draws 1049 of the page's borders, the highest-frequency color on the surface
- 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.
railway.comExplore 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.
Related reading
Specs, directories, and component libraries that pair with this design system.
Browse all design systems
The full directory of DESIGN.md files on shadcn.io, with live mockups for each.
Railway — official site
Deploy web apps, servers, databases, and AI agents on the all-in-one Railway cloud.
The DESIGN.md specification
Google Labs' open spec for machine-readable design system files.
Use Railway in your project
One machine-readable file. Drop it into Claude, Cursor, or any AI tool that reads DESIGN.md.