Skip to content

Release Notes - v0.2.0

Release Date: 2026-04-04

Highlights

  • CLI tool (dss) for generating code artifacts and validating implementations
  • Code generators for CSS (Tailwind v4, CSS vars, SCSS), React TypeScript types, and LLM context prompts
  • Comprehensive MkDocs documentation site with specification reference

What's New

CLI Tool (cmd/dss)

A command-line interface for working with design system specifications:

  • dss generate - Generate code artifacts from your spec
  • --css - Tailwind v4 @theme, CSS custom properties, SCSS, or MkDocs Material
  • --types - React TypeScript interfaces with JSDoc
  • --llm - Markdown or XML context documents for AI code generation
  • dss validate - Check implementations against the spec
  • dss info - Display design system metadata
  • dss lint - Lint spec files for completeness
  • dss coverage - Show token coverage report

Code Generators

CSS Generator (gen_css.go):

  • Tailwind v4 @theme block format
  • Plain CSS custom properties
  • SCSS variables
  • MkDocs Material theme integration

React Generator (gen_react.go):

  • TypeScript interfaces for all components
  • Variant and size union types
  • JSDoc comments with LLM context (@purpose, @contexts)

LLM Prompt Generator (gen_llm.go):

  • Markdown format optimized for AI comprehension
  • XML format for structured parsing
  • Includes tokens, components, patterns, anti-patterns, accessibility

Agent Specification

Design-compliance agent (agents/specs/design-compliance.md) for automated UI code review:

  • Deterministic checks via dss lint
  • LLM-based subjective review criteria
  • Compliance report format
  • CI integration with JSON output

SDK Enhancements

  • FontFamily.Stack - CSS font-family fallback stacks
  • FontFamily.Weights - Available font weights
  • FontFamily.Source - Font loading URL
  • Loader support for border-width.json, opacity.json, z-index.json

Documentation Site

MkDocs documentation with Material theme:

  • Getting started guide
  • CLI reference
  • Full specification reference for all 9 layers
  • Go SDK documentation
  • PlexusOne case study

Changed

  • Merged nested sdk/go module into root module (import path unchanged)
  • Rewrote README focusing on AI-native development goals
  • Restructured TASKS.md around AI compliance goals

Fixed

  • Resolve golangci-lint findings (unused parameters, ineffectual assignments)
  • Remove redundant newline in fmt.Println causing go vet error

Installation

# CLI tool
go install github.com/plexusone/design-system-spec/cmd/dss@v0.2.0

# Go SDK
go get github.com/plexusone/design-system-spec@v0.2.0

Quick Start

# Generate LLM context from your design system
dss generate --llm ./DESIGN_CONTEXT.md

# Generate Tailwind v4 CSS
dss generate --css ./src/index.css

# Validate component implementations
dss validate ./src/components

What's Next

See TASKS.md for the roadmap:

  • Phase 4 - Enhanced LLM context (XML format, compositions, negative examples)
  • Phase 5 - Enhanced validation (color contrast, composition rules)
  • Phase 6 - CLI enhancements (dss init, dss diff)
  • Phase 7 - CI/CD integrations (GitHub Action, pre-commit hooks)