Changelog

[0.2.0] — 2026年05月26日

Added

• Tailwind CSS v4 export — New --format css-tailwind emits a CSS @theme { ... } block using Tailwind v4's native CSS-variable token namespaces (--color-*, --font-*, --text-*, --leading-*, --tracking-*, --font-weight-*, --radius-*, --spacing-*). (#45) — by @sbrsubuvga
• CSS Color Module format support — The validator and linter now accept standard and CSS Color Module color formats. (#73) — by @dalmaer
• Windows-friendly designmd bin alias — The dot-free designmd alias resolves cleanly via PATHEXT on Windows, where the original design.md shim was opened as a Markdown file instead of being executed. (#62) — by @voidborne-d
• Component token diff — The diff command now includes component changes (button styles, added/removed component tokens) that were previously silently skipped. (#51) — by @Saatvik-GT

Changed

• Renamed Tailwind export formats for clarity and backwards compatibility: css-tailwind (v4 CSS), json-tailwind (v3 JSON), and tailwind is preserved as a backwards-compatible alias for json-tailwind. (#64)

Fixed

• Orphaned-token false positives — MD3 paired tokens (e.g. on-primary, primary-container) and baseline families are no longer flagged as orphans when a sibling token is in use. (#59) — by @mvanhorn
• Numeric component property crash — Properties like fontWeight: 600 no longer crash the model handler when passed to string-only validation functions. (#43) — by @tejas55bk
• Transparent hex colors — 8-digit hex colors with alpha (e.g. #FFFFFF00) are now supported. (#24) — by @tototofu123
• Token reference resolution — References in rounded and spacing sections are now resolved correctly. (#26) — by @tejas55bk

Maintenance

• Updated GitHub Actions checkout from v4 to v6. (#58) — by @christianoliff
• Clarified npm install instructions on Windows and added a registry smoke test to CI. (#57) — by @camilojheans

New Contributors

• @sbrsubuvga made their first contribution in #45
• @camilojheans made their first contribution in #57
• @Saatvik-GT made their first contribution in #51
• @tejas55bk made their first contribution in #43
• @voidborne-d made their first contribution in #62
• @christianoliff made their first contribution in #58
• @mvanhorn made their first contribution in #59
• @tototofu123 made their first contribution in #24

Release Notes: @google/design.md v0.1.1

This is a patch release updating the documentation to correctly reflect the available CLI commands.

📝 Documentation Updates

• Updated Command References: Replaced documentation for the outdated tailwind command with the correct export command.
• Clarified Interoperability: Documented how to use export to generate both Tailwind CSS themes and DTCG tokens:

  npx @google/design.md export --format tailwind DESIGN.md > tailwind.theme.json
  npx @google/design.md export --format dtcg DESIGN.md > tokens.json

Release Notes: @google/design.md v0.1.0

We are excited to announce the initial open-source release of @google/design.md, an agent-first CLI and linter for the DESIGN.md format. This tool bridges the gap between design systems and code by providing a formal, machine-readable way to validate and compile design tokens documented in markdown.

🚀 Features

• Design System Linter: Validates DESIGN.md files against the formal spec, catching unresolved references, circular dependencies, and invalid token values.
• Spec Generator: Generates human-readable specification documentation from the core schema.
• Agent-First Design: Deterministic JSON output and silent execution modes optimized for AI agents performing design system maintenance.

🛠 Improvements & Fixes

• Clean JSON Output: Purged debug logging to ensure output is pure JSON and safe for piping to other tools or AI agents.
• Windows Shell Compatibility: Added designmd binary alias to prevent Windows from confusing the .md extension with a file association.
• Startup Reliability: Resolved module loading issues that could cause crashes on import.
• Self-Contained Package: Optimized the package to be self-contained, reducing install size and avoiding dependency conflicts.

📦 Installation

Install globally via npm or bun:

npm install -g @google/design.md
# or
bun add -g @google/design.md

Or run directly via npx:

npx @google/design.md lint DESIGN.md

(Windows users: use npx designmd if file extension associations cause issues).