Concepts
What is a design.md?
Section titled “What is a design.md?”A design.md is a single Markdown file that describes a site’s visual language in a form that is useful to both humans and code-generating agents. getdesign writes one by rendering the target URL in a real browser, reading computed styles, clustering tokens, and emitting nine sections.
The nine sections
Section titled “The nine sections”- Visual theme and atmosphere
- Color palette, with hex values and semantic roles
- Typography: families, weights, sizes, letter-spacing
- Components: buttons, inputs, cards, with measured properties
- Layout and spacing scale
- Depth, shadows, and borders
- Motion: timing, easing, transform patterns
- Responsive behavior
- Prompt guide: ready-to-use instructions for an LLM to produce matching UI
Grounded in real CSS
Section titled “Grounded in real CSS”getdesign is not a static HTML scraper. It runs a real headless browser, walks the rendered DOM, and reads computed styles on representative nodes. Colors and type scales are clustered so that output reflects the site’s actual decisions, not one-off values.
One agent, five surfaces
Section titled “One agent, five surfaces”The core extractor is identical across Web, API, CLI, SDK, and Skill. Only the transport changes. This means an answer you get from the CLI is the same answer you get from the web chat, and pairs with the SDK the same way.