DESIGN.md · explainx registry
Medium
Medium's design system is a "Masterclass in Reading." It is an elegant, editorial environment that prioritizes the written word through high-quality typography and a monochrome-first aesthetic.
Design System#design#ui#ux#template
DESIGN.md (markdown body)
| name | Medium |
| colors | background: "#ffffff" foreground: "#000000" brand: "#15693b" # Medium Green muted: "#757575" border: "#e6e6e6" card: "#ffffff" accent: "#15693b" dark: background: "#000000" foreground: "#ffffff" muted: "#a8a8a8" border: "#292929" card: "#000000" accent: "#15693b" |
| typography | fontFamily: serif: "Charter, Georgia, serif" display: "Noe Display, serif" sans: "Inter, system-ui, sans-serif" body: fontFamily: serif fontSize: "20px" # Large, comfortable reading size lineHeight: "1.6" heading: fontFamily: display fontWeight: "700" letterSpacing: "-0.02em" |
| rounded | default: "4px" full: "9999px" |
Design System: Medium
Overview
Medium's design system is a "Masterclass in Reading." It is an elegant, editorial environment that prioritizes the written word through high-quality typography and a monochrome-first aesthetic.
Design Philosophy
- Readability above All: Every design choice—from font selection to line length—is optimized for deep, focused reading.
- Editorial Sophistication: Uses high-contrast serifs to evoke the feeling of a premium physical magazine or literary journal.
- Monochrome Restraint: Primarily uses Black and White to reduce visual noise, with Green as the single point of brand focus.
- The Writer as Hero: The UI is a canvas for the writer's ideas, featuring minimal decoration and a focus on clean metadata.
Colors
- Medium Green (#15693B): A deep, organic green used for primary actions (Follow, Sign Up) and brand identity. It represents growth and knowledge.
- Pure Monochrome: Uses absolute Black (#000000) for text and absolute White (#FFFFFF) for the canvas to ensure maximum contrast.
- Subtle Overlays: Uses very light grey overlays for metadata and secondary navigation.
Typography
- Noe Display: A high-contrast, elegant serif used for impactful headlines. It provides the "editorial" voice.
- Charter: A workhorse serif designed for reading on screens. It is warm, balanced, and reduces eye fatigue.
- Inter: A clean, neutral sans-serif used for the "plumbing" of the site (menus, buttons, metadata).
Components
- The Article Feed: A minimalist vertical list with large, bold headlines and small, muted metadata.
- Subscribe/CTA: Usually a simple, green outlined button or a solid green pill.
- Clap Button: A playful, interactive icon that represents social engagement without the weight of a traditional "Like" button.
Visual Effects
- Generous Leading: High line-height (1.6x) to create a relaxed, airy reading experience.
- Drop Caps: Used occasionally at the start of articles to add a classic editorial flourish.
- Smooth Image Loading: Uses a blurred-to-sharp "progressive" image loading effect to maintain the feeling of speed.
Usage
- Copy DESIGN.md into your project or paste it into your IDE agent chat.
- Ask your assistant to follow the tokens for color, typography, spacing, and component styling.
- When collaborating, share the file directly—or tap “Copy page link” below so teammates open the same snapshot.
Common questions
- What is Medium on explainx.ai?
- Medium's design system is a "Masterclass in Reading." It is an elegant, editorial environment that prioritizes the written word through high-quality typography and a monochrome-first aesthetic. Listed under category “Design System”. Explainx.ai mirrors the full DESIGN.md document so assistants can cite stable tokens and prose in one place.
- What is DESIGN.md?
- DESIGN.md blends YAML design tokens—colors, typography, spacing, radii—with markdown that explains intent. Google documents this pattern for agent-driven UI work under Stitch (stitch.withgoogle.com).
- How do I use this with ChatGPT, Cursor, Claude Code, or another IDE agent?
- Paste the DESIGN.md into your repo root or attach it to the agent conversation, then ask explicitly for layouts, spacing, palette, type scale, and component tone that follow the document. Refresh from this listing when upstream authors publish changes.
- Where is the source repo?
- Maintainers link to github.com/whyashthakker/design-md-templates-skills. Community listings on explainx.ai may reference popular aesthetic names for inspiration; that does not imply official endorsement by any trademark holder.
- How current is this DESIGN.md?
- Explainx snapshots the file at import time. Recorded last update on this listing: May 8, 2026.
- Need a fresh DESIGN.md from scratch?
- Use the ExplainX DESIGN.md generator to describe your product and audience; it returns Stitch-style YAML plus narrative guidance you can publish or submit to the registry afterward.
Still exploring the format? Browse the full DESIGN.md registry or draft a new system with our DESIGN.md generator.
Community listing for AI design workflows—not necessarily affiliated with any brand referenced in the name or summary. For context on the format, see Google Stitch.
List Your Design.md
Share your design system with AI agents worldwide