31 DESIGN.md examples for AI coding agents, by style and industry
Every DESIGN.md example in the freedesignmd library, grouped by style and industry, with what each one is built for. Pick the closest one, copy it, change the brand color.

Key takeaways
- There are 31 DESIGN.md examples in the library, each a complete design system with a live preview.
- Pick by feeling and industry first; colors and fonts are the easiest parts to change later.
- Every example uses the same section order, so switching systems means replacing one file.
The fastest way to understand a format is to read good examples of it. This page lists every DESIGN.md example in the freedesignmd library, 31 in total, grouped by style and industry. Each one is a complete design system written as a single DESIGN.md, with a live preview rendered from the same tokens you download.
New to the format? Read what a DESIGN.md file is first, then come back and pick one.
How to choose a DESIGN.md example
Choose by feeling and audience, not by color. Colors and fonts are the easiest tokens to change. The hard part, the one that takes a designer days, is the set of decisions around them: how dense the layout is, how much radius, how loud the type, what motion is allowed. That is what a good example gives you.
- Name the feeling in two words: calm and clinical, loud and editorial, dark and technical.
- Match the industry: every example below says what it was built for.
- Open the preview and check it in light and dark. Every system specifies both modes.
- Copy the file, save it as DESIGN.md, then change the primary color and display font if you need to.
Minimal and product DESIGN.md examples
Quiet chrome, one accent, dense where it needs to be. Good defaults for SaaS, AI products and tools.
- Minimalistic: Apple-like minimal design system for landing pages and product UI: monochrome chrome, one blue accent, medium-weight type, generous whitespace, and Liquid Glass reserved for navigation and controls.
- Linear Orbit: Dark, hairline product workspace: near-black canvas, Inter Tight with tight tracking, one indigo action color and 1px dividers at 8% white. Built for issue trackers, roadmaps and keyboard-first tools.
- Signal AI: Clean AI chat product on a quiet white canvas with Geist type and exactly one signal-orange for the assistant's live state. Built for copilots, assistants and agent consoles.
- Prism Conic: White-light refraction for AI products: a pale lavender canvas, ink-violet actions and a single conic spectrum gradient that appears as a halo, a border or a loader. Bricolage Grotesque headings with Hanken Grotesk body.
- Argent Machined: Cool silver CNC precision: hairline drawings, 2px corners, dimension ticks, Space Grotesk headings and a single blueprint cobalt. For engineering software, simulation, CAD and metrology products.
- Titanium Deck: Brushed-titanium hardware spec sheet: warm grey metal surfaces with fine grain, beveled edges, Mona Sans headings, Geist text, Geist Mono model numbers and a single safety-orange action. For hardware, industrial and tooling brands.
Glass and chrome DESIGN.md examples
Frosted panes, mirror chrome and neon. For consumer apps, trading screens, music and creative tools.
- Aurora Glass: Soft frosted glass over drifting peach, lilac and mint color bleeds, with a calm teal action color and rounded Plus Jakarta Sans. Made for wellness, meditation, sleep and habit apps.
- Obsidian Glass: Smoked-glass trading terminal: a near-black blue canvas, 28px-blur panes with a bright top edge, Space Grotesk headings and tabular mono prices. Built for crypto exchanges, portfolio trackers and market dashboards.
- Liquid Metal: Mirror-chrome gradients on graphite: wide Unbounded headlines, specular highlights on every edge and a monochrome palette that lets creative work be the only color. For design tools, motion studios and 3D software.
- Acid Chrome: Y2K acid-green chrome on black: Syne ExtraBold in caps, pill buttons with a banded chrome stripe, hot-pink flares and Space Mono ticket details. For clubs, festivals, labels and music platforms.
Editorial and print DESIGN.md examples
Serif headlines, paper tones and real typographic contrast. For publishers, newsletters, fashion and makers.
- Warm Editorial: Cream newsroom serif: newsprint-warm paper, Fraunces headlines, Source Serif body and one oxblood ink for rules, links and the main action. Built for newsletters, regional papers and long-read publications.
- Magazine Bold: Loud tabloid grotesque with a hot red accent: Anton headlines in caps, Archivo text, yellow highlighter and black rules. For pop culture, fashion weeklies and celebrity news.
- Maison Folio: Couture black-and-ivory: a gigantic Bodoni Moda didone on warm ivory, one black ink, zero radius and a brutal scale gap between hero and body. For fashion houses, lookbooks and atelier campaigns.
- Risograph Press: Two-ink riso print for indie publishers: uncoated paper stock, riso blue and fluorescent pink overprinting, Bricolage Grotesque headlines and Source Serif reading text. Built for zine shops, small presses and independent bookstores.
- Parchment Atelier: Craft and artisan on parchment and ink: toasted paper, iron-gall ink blue, Newsreader headlines, Albert Sans text and typewriter-grade Plex Mono stamps. For bookbinders, ceramicists, letterpress and small-batch makers.
Developer, terminal and grid DESIGN.md examples
Monospace, hairlines and visible grids. For docs, CLIs, editors, ops consoles and infrastructure.
- Dark Terminal: Phosphor-green CRT for ops consoles: near-black glass, VT323 headlines, IBM Plex Mono data and a single 39ff7a glow color. Built for observability, on-call and deploy tooling.
- Devshell Mono: Light IDE-style documentation set entirely in monospace: warm paper white, JetBrains Mono headings, Red Hat Mono body and a single blueprint-blue link color. Built for API references, CLI manuals and SDK docs.
- Monolith CLI: Single-hue slab docs: every color is a tint or shade of deep teal, set in Zilla Slab headlines over Public Sans with Overpass Mono commands. Built for CLI manuals, internal platform docs and build tools.
- Citrine IDE: Warm editor theme in cream and citrine yellow with Bricolage Grotesque headlines and DM Mono code. Built for code-editor products, snippet libraries and developer education.
- Null Grid: Swiss brutalist black and white on a visible 12-column grid: Archivo heavy headlines, Azeret Mono data, 2px rules and zero radius. Built for infrastructure, network and data-platform companies.
Fintech and crypto DESIGN.md examples
Numbers first: tabular figures, one highlight color and calm surfaces for money.
- Iris Pay: Payments infrastructure in ink and saffron: Newsreader headlines, warm paper surfaces, near-black actions and a single saffron highlight for the number that matters. Built for business accounts, payment dashboards and checkout.
- Stadium Bank: Sports-bank energy in bold navy and lime: condensed Barlow headlines, scoreboard numerals, a deep navy canvas and a single volt-lime action color. Built for fan-club banking, sports membership and fantasy-finance apps.
- Token Mesh: Gradient-mesh crypto-dev surface: midnight canvas with violet, cyan and magenta light pools, Syne headlines and Martian Mono figures. Built for wallets, L2 chains and on-chain developer platforms.
Hospitality, health and lifestyle DESIGN.md examples
Warm, photo-first and accessible systems for hotels, rentals, clinics, wellness and luxury.
- Hotel Riviere: Riviera hospitality in sea-blue and sand: sun-bleached ivory, deep Mediterranean teal, Instrument Serif headlines and Hanken Grotesk text. For boutique hotels, beach clubs and coastal restaurants.
- Wanderstay Rentals: Warm travel marketplace in terracotta and sand: Fraunces headlines, Plus Jakarta Sans UI, photo-first listing cards and a sunset-clay booking button. Built for holiday rentals, boutique stays and host dashboards.
- Clinic Pearl: Calm healthcare in pearl and teal: Hanken Grotesk at generous sizes, soft pearl surfaces, one deep teal action color and clinical status colors that never alarm. Built for patient portals, booking and care dashboards.
- Soft Linen: Quiet wellness and home goods in washed linen: Fraunces headlines, DM Sans body, a sage action color and slow, weightless motion. Built for candle, bedding and tea shops, spa booking and slow-living brands.
- Champagne Foundry: Gold-on-ink fine jewellery: lacquer-black canvas, a brushed champagne-gold primary, Cormorant Garamond display and fine tracked Jost labels. For jewellers, watchmakers and private-client houses.
- Atrium Folio: Architecture portfolio in poured-concrete grey: cool mineral surfaces, Familjen Grotesk headings, mono drawing labels and a single safety-orange signal. For studios, project archives and competition entries.
Playful DESIGN.md examples
Thick outlines, confetti palettes and pixel type. For kids, education and games.
- Neo Memphis: Playful Memphis geometry for kids and education: chunky Fredoka headlines, thick ink outlines, hard offset shadows and a confetti palette of tomato, sun yellow, mint and sky. Built for learning apps, school tools and family products.
- Arcade Night: Neon pixel-adjacent game launcher: Silkscreen headings, Chakra Petch UI, a dark purple cabinet canvas with magenta and cyan glow edges. Built for game stores, launchers, esports and leaderboard pages.
What makes these good DESIGN.md examples
A DESIGN.md is only useful if an agent can follow it without guessing. Every example in the library has:
- Exact values for every color role in light and dark mode, with contrast ratios next to the text pairs.
- A type scale with size, mobile size, line height, weight and tracking for each role.
- Spacing, radius, shadow and motion tokens, including durations and easing curves.
- Component recipes as HTML and CSS for button, input, card, badge, navigation, tabs, table, dialog and link.
- A Do / Don't list that names the mistakes an agent would otherwise make.
- A tokens.css block you paste into your stylesheet.
The library checks this on every build: hex values and durations mentioned in the prose must exist as tokens, and every section must be present in order. That keeps the examples honest.
Using an example with your AI coding tool
Save the file as DESIGN.md in your project root, then tell your tool to follow it. The setup per tool is short: Claude Code reads it through CLAUDE.md, Cursor through a rule in .cursor/rules, and Lovable through Project Knowledge. After that, short prompts like "build a pricing page" come back in your style.
Want a whole page instead of a system? The free landing page templates each ship with their own DESIGN.md.
Can't find a match?
Take the closest example and edit it. Change the primary color, swap the display font, adjust the radius. Then read how to write a DESIGN.md for the parts worth rewriting in your own words: the personality, the signature moves and the Do / Don't list.
Frequently asked questions

Written by Tammo Elsner
Founder of freedesignmd, a free DESIGN.md library for AI coding agents. About the project · LinkedIn


