design-md

You can export design tokens to Tailwind theme JSON by placing a DESIGN.md file at your project root and running the design-md export, which parses YAML front matter and markdown rationale into a structured theme configuration.

A DESIGN.md file is a single-source-of-truth specification that combines YAML front matter and markdown rationale to describe visual identity tokens. You need it when maintaining a machine-readable spec alongside a human-readable design narrative.

Yes, you can lint DESIGN.md files to validate required sections, token references, well-formed metadata, and WCAG contrast compliance, ensuring correctness and consistency across your design system workflows.

You diff design token versions by running the design-md workflow on your DESIGN.md file, which detects regressions in token values and narrative sections to maintain consistency across project updates.

Yes, the design-md workflow supports exporting tokens to W3C Design Tokens JSON (DTCG) format, enabling integration with design systems and tooling that rely on the standard DTCG specification.

The required YAML frontmatter fields for a DESIGN.md file are name and description, which validate the file structure and ensure the token taxonomy and tooling referenced in the spec function correctly.