designmd

DesignMD measures real production websites in a headless browser to capture computed styles, CSS cascade typography, live @media breakpoints, and hover/focus states from the CSSOM. It synthesizes these measurements into a structured DESIGN.md specification that developers can feed directly into AI coding assistants like Cursor, Claude Code, Windsurf, Aider, or Copilot. The CLI requires Node 18+ and can be run via npx or installed globally. Usage is simple: `dmd stripe.com > DESIGN.md` streams the markdown to stdout, while `--json` outputs raw tokens instantly without LLM processing. The tool supports custom API endpoints for self-hosting via the DESIGNMD_API environment variable. Key features include: live browser measurement (not static analysis), portable markdown output that survives LLM context windows, diff-able and re-generable specs, and integration guides for major AI coding agents. Anonymous usage is limited to 5 generations per day per IP; the --json flag bypasses this limit. The repository contains the CLI source, sample DESIGN.md outputs for sites like Stripe, Linear, Vercel, Notion, Anthropic, Mercury, Figma, and Airbnb, documentation, and integration guides. The extraction pipeline, LLM prompts, and server infrastructure remain proprietary.