$ show VoltAgent/awesome-design-md
This repository is a curated collection of design system analyses for over 70 brands, each documented in a standardized DESIGN.md file. The analyses reverse-engineer public websites to extract design tokens (colors, typography, spacing, components) and present them in a machine-readable YAML front matter format alongside human-readable prose sections. The repo serves as a reference dataset for design system research, AI-assisted UI generation, and cross-brand comparison. It is not a software application or a traditional data pipeline; rather, it is a hybrid content repository that blends design research with structured data extraction. The project is maintained by VoltAgent and includes a commercial layer for requesting new analyses. While the data is well-structured and consistent, the analyses are static snapshots that may drift from live sites, and some files contain placeholder markers or typos.
The LLM identified 3 files worth highlighting for reuse:
A comprehensive design system analysis for Spotify, including YAML front matter with colors, typography, spacing, and component definitions. The file demonstrates the standardized template used across all brands, with token references (e.g., {colors.primary}) linking prose to structured data. It is reusable as a template for documenting any brand's design system and can be parsed programmatically for UI generation.
An example of the newer 'alpha' format with detailed YAML front matter and component variants (pressed, disabled, active). The file includes an 'Agent Prompt Guide' and 'Iteration Guide' sections, making it directly usable for AI-driven UI generation. The token reference pattern and component structure are reusable across projects.
A thorough analysis of Figma's design system, including a detailed typography hierarchy table, responsive breakpoints, and component definitions. The file is notable for its completeness and clear documentation of known gaps. It serves as a high-quality reference for understanding how to document a complex design system in a reusable, token-based format.