DesignMD
DesignMD extracts production-grade design systems from any URL into a DESIGN.md spec for AI coding agents like Cursor and Claude.
DesignMD is a specialized tool designed to bridge the gap between production frontends and AI-native development workflows. Created by Aditya Raj, it allows users to convert any website's visual identity into a structured "design DNA" specification. By analyzing the live code of a site rather than relying on visual inference from screenshots, it provides a highly accurate technical reference for design systems.
The tool primarily serves as a context provider for AI coding agents like Cursor, Claude Code, and GitHub Copilot. It organizes complex frontend data—such as CSS variables, responsive breakpoints, and interaction states—into a human-readable and AI-parsable Markdown format, typically named DESIGN.md or AGENTS.md. This allows developers to give LLMs a precise map of an existing UI to ensure code generation stays on-brand and technically consistent.
DesignMD functions by performing a deep structural analysis of the provided URL's DOM and CSSOM. It retrieves computed styles, media queries, and z-index ladders directly from the browser's rendering engine. This ensures that the extracted tokens are not guesses but actual production values, including specific contrast ratios and animation declarations used on the live site.
Some of the key features are:
- DOM & CSSOM Extraction: Gathers real CSS variables, media query breakpoints, and computed styles directly from the live frontend code.
- AI-Ready Output: Generates structured Markdown files specifically formatted to provide architectural context for AI coding agents and LLMs.
- Comprehensive Token Discovery: Captures color palettes, typography scales, spacing units, and border-radius systems without manual inspection.
- Interactive State Recovery: Detects hover and focus states, transition rules, and keyframe animations from the source stylesheets.
- Accessibility Auditing: Measures WCAG contrast pairs to identify accessibility levels for extracted color combinations used in production.
- Multi-Format Export: Provides data in Markdown, JSON, or raw extraction formats for versatile integration into various development pipelines.
- Benchmark Gallery: Offers an extensive library of pre-measured design systems from major platforms like Stripe, Linear, Vercel, and GitHub for reference.
To operate the tool, a user simply enters a URL into the web interface. In approximately 12 seconds, DesignMD processes the site's stylesheets and structure to generate a comprehensive report. Users can then preview the extracted typography and color palettes, copy the Markdown text directly, or download the full DESIGN.md file to drop into their local project directory for immediate use with AI tools.
Some common use cases include:
- AI Agent Grounding: Providing a DESIGN.md file to Cursor or Claude Code to ensure generated UI components match an existing design system's tokens.
- Design System Auditing: Extracting and reviewing the design tokens of a live website to document or analyze its technical implementation details.
- Competitive Analysis: Benchmarking the responsive breakpoints and spacing scales of industry-leading websites for technical reference.
- Frontend Documentation: Rapidly generating documentation for an existing project that lacks a formalized design system specification.
- Migration Reference: Capturing CSS variables and component patterns when migrating a legacy site to a modern framework while maintaining visual fidelity.
Comments
0Markdown is supported.