About this project

## What it is design-md-hub is an open-source repository of 120 brand design systems, each captured as a single plain-text `DESIGN.md` file that AI coding agents can read. Every spec is reverse engineered from the brand's live production website, so the recorded fonts, hex values, logos and copy come from the actual source rather than being guessed. Values that cannot be confirmed from the live site are omitted. ## What a DESIGN.md contains - Color palettes and semantic tokens - Typography scale and font choices - Component patterns and variants - Spacing, shadows and border radius - Layout principles and responsive behavior - Tone, guardrails and dos/don'ts Each brand folder also ships a self-contained `preview.html` that opens directly in a browser with no build step, so the visual identity can be inspected. ## Workflow described in the README 1. A brand's live site is fetched (HTML, CSS, fonts) and real tokens are extracted. 2. Those tokens become a plain-text `DESIGN.md` spec. 3. A matching `preview.html` demonstrates the identity in a browser. 4. A coding agent reads the `DESIGN.md` to generate UI in that brand's voice. ## Coverage The collection spans developer tools, AI/LLM products, design tools, fintech, analytics, observability, productivity apps, auth services, data platforms, commerce and automation. Named examples include GitHub, Figma, Cursor, Linear, Stripe, Vercel, Supabase, Notion, Docker, MongoDB, Cloudflare, OpenAI, Claude, Mistral AI, ElevenLabs, Tailwind CSS, shadcn/ui, n8n, Zapier, Grafana and many others. A live gallery site is linked from the README for browsing previews. ## How to use it 1. Pick a `DESIGN.md` from the listed collection. 2. Copy it into the root of your project. 3. Instruct your coding agent to follow the DESIGN.md in the project root. 4. Generate components, pages or whole apps with consistent styling. No paywalls, signups or API keys are required; contributions are accepted via the repository's CONTRIBUTING.md. ## Caveats The README states these specs are unofficial references built for education and prototyping, reverse engineered from public brand sites, and are neither endorsed by nor affiliated with the brands. Trademarks and logos remain with their owners. The project is licensed under MIT.