extract-design

Extract Design Language

Extract the complete design language from any website URL. Generates 8 output files covering colors, typography, spacing, shadows, components, breakpoints, animations, and accessibility.

Prerequisites

Ensure designlang is available. Install if needed:

npm install -g designlang

Or use npx (no install required):

npx designlang <url>

Process

1. Run the extraction on the provided URL:

npx designlang <url> --screenshots

For multi-page crawling: npx designlang <url> --depth 3 --screenshots For dark mode: npx designlang <url> --dark --screenshots

1. Read the generated markdown file to understand the design:

cat design-extract-output/*-design-language.md

1. Present key findings to the user:
2. Primary color palette with hex codes
3. Font families in use
4. Spacing system (base unit if detected)
5. WCAG accessibility score
6. Component patterns found
7. Notable design decisions (shadows, radii, etc.)

1. Offer next steps:
2. Copy *-tailwind.config.js into their project
3. Import *-variables.css into their stylesheet
4. Paste *-shadcn-theme.css into globals.css for shadcn/ui users
5. Import *-theme.js for React/CSS-in-JS projects
6. Import *-figma-variables.json into Figma for designer handoff
7. Open *-preview.html in a browser for a visual overview
8. Use the markdown file as context for AI-assisted development

Output Files (8)

| File | Purpose | |------|---------| | -design-language.md | AI-optimized markdown — the full design system for LLMs | | -preview.html | Visual HTML report with swatches, type scale, shadows, a11y | | -design-tokens.json | W3C Design Tokens format | | -tailwind.config.js | Ready-to-use Tailwind CSS theme | | -variables.css | CSS custom properties | | -figma-variables.json | Figma Variables import format | | -theme.js | React/CSS-in-JS theme object | | -shadcn-theme.css | shadcn/ui theme CSS variables |

Additional Commands

• Compare two sites: npx designlang diff <urlA> <urlB>
• View history: npx designlang history <url>

Options

| Flag | Description | |------|-------------| | --out <dir> | Output directory (default: ./design-extract-output) | | --dark | Also extract dark mode color scheme | | --depth <n> | Crawl N internal pages for site-wide extraction | | --screenshots | Capture component screenshots (buttons, cards, nav) | | --wait <ms> | Wait time after page load for SPAs | | --framework <type> | Generate only specific theme (react or shadcn) |