design-md

DESIGN.md is a design specification format that uses YAML frontmatter to define tokens and a Markdown body for rationale. It solves the problem of maintaining visual identity consistency by providing a single, human-readable source of truth for design systems.

You author tokens in YAML frontmatter and provide rationale in the Markdown body, then lint the structure, diff versions, and export to Tailwind or DTCG JSON. This workflow enforces WCAG contrast checks and multi-format export capabilities for project implementation.

DESIGN.md linting applies WCAG contrast checks to color tokens to ensure accessibility compliance. It also validates YAML frontmatter structure and token references to catch inconsistencies before exporting to Tailwind or DTCG JSON.

DESIGN.md version diffing compares changes in YAML frontmatter token values and Markdown rationale across spec iterations. This identifies structural updates and token reference modifications before exporting to Tailwind or DTCG JSON.

DESIGN.md manages design tokens by defining color, typography, and spacing values in YAML frontmatter with consistent references. It lints structure, checks WCAG contrast, and exports to Tailwind or DTCG JSON for reuse across multiple project design systems.