About Fly.io DESIGN.md
Curated by Dov AzencotUpdated Source fly.io
- Web Infrastructure & Hosting
- Developer Tools & IDEs
Fly.io's marketing page is what happens when a developer-infrastructure brand decides the right reference is not Linear and not Vercel but a children's storybook. The canvas is a near-white "#f1f2f9", every headline is set in Mackinac — a soft humanist serif loaded at exactly weight 500 with a punishing "-2.88px" tracking at the 64px hero size — and the section dividers are not hairlines but illustrated dragons, fish, and tools rendered in the same dusty-pastel palette as the brand's gradient. The text color is "#281950", a deep ink-violet that reads almost as navy until you put it next to actual navy and watch it tilt purple. The whole page reads as a hand-drawn periodical that happens to sell sandboxes and private networking.
This DESIGN.md packages the system into a single machine-readable file following the Google Labs spec. Inside: 22 color tokens (the deep "#281950" violet-ink primary, the four-stop rainbow gradient set of cyan "#7dd3fc" / indigo "#a5b4fc" / pink "#f9a8d4" / violet "#a02be4", a single saturated CTA violet "#7c3aed", the structural lavender hairline "#e7e6f4" with 267 occurrences across the page, plus dark-band accents for the closing footer), 12 typography tokens across Mackinac serif and Fricolage Grotesque sans, 6 radii from 0px to a 9999px pill, 9 spacing values built around a 32px base, and 18 components covering the violet CTA, the ghost-button pair, the illustrated section card, the dark "Use the Tech You Love" band, and the global nav.
Feed the file to Claude, Cursor, or Copilot when you want a React surface that reads as Fly.io — soft canvas, illustrated rather than iconographic, serif headlines at weight 500, a single violet conversion target. The agent picks up the constraints: never escalate Mackinac past 500, never flat-fill the rainbow stops, never replace "#e7e6f4" with a darker hairline. Reference the tokens directly in Tailwind config or use the spec as an audit checklist against the page. Where most developer-infra brands signal seriousness with grayscale and weight 600 sans, Fly.io signals it by setting the entire page in serif and trusting illustration to do the rest.
What makes it distinct
- Storybook-on-infrastructurehand-illustrated dragons and fish frame every section heading on a developer compute platform
- Mackinac at weight 500 only64px hero with '-2.88px' tracking carries display, never escalating to 600 or italic for emphasis
- Single violet CTA'#7c3aed' is the only saturated filled surface, paired with a hairline-bordered ghost button on every section
- Lavender hairline as the structural voice'#e7e6f4' draws 267 of every divider, border, and card edge across the page
- Four-stop rainbow as glow not fillcyan, indigo, pink, violet appear only as radial gradients under illustrations, never as filled backgrounds
Live at fly.io
A snapshot of the brand in production. Hover the frame to scroll the page; click to visit.
fly.ioExplore Fly.io
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.
Other
Specialty colors.
Fly.io design system FAQ
Common questions about Fly.io'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.
Use Fly.io in your project
One machine-readable file. Drop it into Claude, Cursor, or any AI tool that reads DESIGN.md.