google-labs-code/design.md

Health v2 · maintenance only

Flags: young

Adoption not part of the score

27525 stars · 2285 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

DESIGN.md is a format specification for describing a visual identity and design system to coding agents, combining YAML design tokens with markdown design rationale. It ships with an npm CLI that lints DESIGN.md files, checks WCAG contrast ratios, and diffs two versions for token or prose regressions.

Use cases

• give coding agents a persistent understanding of my design system
• lint a design tokens file for broken references and contrast issues
• check WCAG color contrast ratios in a design spec
• diff two versions of a design system for regressions
• document design tokens and rationale in one file
• make AI-generated UI match my brand guidelines

When to choose

• you use AI coding agents and want them to consistently follow your visual identity
• you need a machine-readable plus human-readable design system file
• you want automated validation of design tokens and accessibility contrast

When to avoid

• you need a full design token build pipeline or theme compilation to CSS
• your project has no AI-assisted development workflow
• you need runtime theming rather than a static specification

Facets

library · maturity active

documentation linter developer-tools cli accessibility web-development frontend web-design developer-tools artificial-intelligence documentation cli cross-platform design-systems design-tokens coding-agents ai-coding specification wcag yaml-front-matter visual-identity nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="google-labs-code/design.md")