npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

awesome-design-md

v1.1.0

Published

Pick a DESIGN.md from curated collection and copy it to your project

Readme

Awesome DESIGN.md Count Last Update Discord

Awesome DESIGN.md

Copy a DESIGN.md into your project, tell your AI agent "build me a page that looks like this" and get pixel-perfect UI that actually matches.

What is DESIGN.md?

DESIGN.md is a new concept introduced by Google Stitch. A plain-text design system document that AI agents read to generate consistent UI.

It's just a markdown file. No Figma exports, no JSON schemas, no special tooling. Drop it into your project root and any AI coding agent or Google Stitch instantly understands how your UI should look. Markdown is the format LLMs read best, so there's nothing to parse or configure.

| File | Who reads it | What it defines | |------|-------------|-----------------| | AGENTS.md | Coding agents | How to build the project | | DESIGN.md | Design agents | How the project should look and feel |

This repo provides ready-to-use DESIGN.md files extracted from real websites.

What's Inside Each DESIGN.md

Every file follows the Stitch DESIGN.md format with extended sections:

| # | Section | What it captures | |---|---------|-----------------| | 1 | Visual Theme & Atmosphere | Mood, density, design philosophy | | 2 | Color Palette & Roles | Semantic name + hex + functional role | | 3 | Typography Rules | Font families, full hierarchy table | | 4 | Component Stylings | Buttons, cards, inputs, navigation with states | | 5 | Layout Principles | Spacing scale, grid, whitespace philosophy | | 6 | Depth & Elevation | Shadow system, surface hierarchy | | 7 | Do's and Don'ts | Design guardrails and anti-patterns | | 8 | Responsive Behavior | Breakpoints, touch targets, collapsing strategy | | 9 | Agent Prompt Guide | Quick color reference, ready-to-use prompts |

Each site includes:

| File | Purpose | |------|---------| | DESIGN.md | The design system (what agents read) | | preview.html | Visual catalog showing color swatches, type scale, buttons, cards | | preview-dark.html | Same catalog with dark surfaces |

How to Use

  1. Copy a site's DESIGN.md into your project root
  2. Tell your AI agent to use it.

Request a DESIGN.md

Open a GitHub issue with this template to request a DESIGN.md generation for a website.

Collection

AI & Machine Learning

  • Claude - Anthropic's AI assistant. Warm terracotta accent, clean editorial layout
  • Cohere - Enterprise AI platform. Vibrant gradients, data-rich dashboard aesthetic
  • ElevenLabs - AI voice platform. Dark cinematic UI, audio-waveform aesthetics
  • Minimax - AI model provider. Bold dark interface with neon accents
  • Mistral AI - Open-weight LLM provider. French-engineered minimalism, purple-toned
  • Ollama - Run LLMs locally. Terminal-first, monochrome simplicity
  • OpenCode AI - AI coding platform. Developer-centric dark theme
  • Replicate - Run ML models via API. Clean white canvas, code-forward
  • RunwayML - AI video generation. Cinematic dark UI, media-rich layout
  • Together AI - Open-source AI infrastructure. Technical, blueprint-style design
  • VoltAgent - AI agent framework. Void-black canvas, emerald accent, terminal-native
  • xAI - Elon Musk's AI lab. Stark monochrome, futuristic minimalism

Developer Tools & Platforms

  • Cursor - AI-first code editor. Sleek dark interface, gradient accents
  • Expo - React Native platform. Dark theme, tight letter-spacing, code-centric
  • Linear - Project management for engineers. Ultra-minimal, precise, purple accent
  • Lovable - AI full-stack builder. Playful gradients, friendly dev aesthetic
  • Mintlify - Documentation platform. Clean, green-accented, reading-optimized
  • PostHog - Product analytics. Playful hedgehog branding, developer-friendly dark UI
  • Raycast - Productivity launcher. Sleek dark chrome, vibrant gradient accents
  • Resend - Email API for developers. Minimal dark theme, monospace accents
  • Sentry - Error monitoring. Dark dashboard, data-dense, pink-purple accent
  • Supabase - Open-source Firebase alternative. Dark emerald theme, code-first
  • Superhuman - Fast email client. Premium dark UI, keyboard-first, purple glow
  • Vercel - Frontend deployment platform. Black and white precision, Geist font
  • Warp - Modern terminal. Dark IDE-like interface, block-based command UI
  • Zapier - Automation platform. Warm orange, friendly illustration-driven

Infrastructure & Cloud

  • ClickHouse - Fast analytics database. Yellow-accented, technical documentation style
  • Composio - Tool integration platform. Modern dark with colorful integration icons
  • HashiCorp - Infrastructure automation. Enterprise-clean, black and white
  • MongoDB - Document database. Green leaf branding, developer documentation focus
  • Sanity - Headless CMS. Red accent, content-first editorial layout
  • Stripe - Payment infrastructure. Signature purple gradients, weight-300 elegance

Design & Productivity

  • Airtable - Spreadsheet-database hybrid. Colorful, friendly, structured data aesthetic
  • Cal.com - Open-source scheduling. Clean neutral UI, developer-oriented simplicity
  • Clay - Creative agency. Organic shapes, soft gradients, art-directed layout
  • Figma - Collaborative design tool. Vibrant multi-color, playful yet professional
  • Framer - Website builder. Bold black and blue, motion-first, design-forward
  • Intercom - Customer messaging. Friendly blue palette, conversational UI patterns
  • Miro - Visual collaboration. Bright yellow accent, infinite canvas aesthetic
  • Notion - All-in-one workspace. Warm minimalism, serif headings, soft surfaces
  • Pinterest - Visual discovery platform. Red accent, masonry grid, image-first
  • Webflow - Visual web builder. Blue-accented, polished marketing site aesthetic

Fintech & Crypto

  • Coinbase - Crypto exchange. Clean blue identity, trust-focused, institutional feel
  • Kraken - Crypto trading platform. Purple-accented dark UI, data-dense dashboards
  • Revolut - Digital banking. Sleek dark interface, gradient cards, fintech precision
  • Wise - International money transfer. Bright green accent, friendly and clear

Enterprise & Consumer

  • Airbnb - Travel marketplace. Warm coral accent, photography-driven, rounded UI
  • Apple - Consumer electronics. Premium white space, SF Pro, cinematic imagery
  • BMW - Luxury automotive. Dark premium surfaces, precise German engineering aesthetic
  • IBM - Enterprise technology. Carbon design system, structured blue palette
  • NVIDIA - GPU computing. Green-black energy, technical power aesthetic
  • SpaceX - Space technology. Stark black and white, full-bleed imagery, futuristic
  • Spotify - Music streaming. Vibrant green on dark, bold type, album-art-driven
  • Uber - Mobility platform. Bold black and white, tight type, urban energy

Contributing

See CONTRIBUTING.md for guidelines.

  • Improve existing files: Fix wrong colors, missing tokens, weak descriptions
  • Report issues: Let us know if something looks off

Before opening a PR, please open an issue first to discuss your idea and get feedback from maintainers.

License

MIT License - see LICENSE

This repository is a curated collection of design system documents extracted from public websites. All DESIGN.md files are provided "as is" without warranty. The extracted design tokens represent publicly visible CSS values. We do not claim ownership of any site's visual identity. These documents exist to help AI agents generate consistent UI.