dembrandt
Extract any website’s design system into tokens in seconds: logo, colors, typography, borders & more. One command.
What is dembrandt?
Extract any website’s design system into tokens in seconds: logo, colors, typography, borders & more. One command.
Overview of dembrandt
What it is
Dembrandt is a command-line tool that extracts a website's design system into tokens: logo, colors, typography, spacing, borders, shadows, motion, components. It outputs W3C design tokens. It requires Node.js 18+ and uses Playwright to drive Chromium. The browser must be installed via dembrandt install-browser or npx dembrandt install-browser.
Key features
- Extracts colors (semantic roles with evidence, curated palette, every detected colour, CSS variables, gradients)
- Extracts typography (fonts, sizes, weights, sources, font file URLs)
- Extracts spacing (margin/padding scales), borders (radius, widths, styles, colors), shadows, motion (duration scale, easing curves, hover patterns per component type)
- Extracts components (buttons, badges, inputs, links), breakpoints, icons & frameworks - Supports export flags: --dtcg (W3C design tokens), --design-md (DESIGN.md for AI agents), --tailwind (Tailwind v4 @theme CSS), --shadcn (shadcn/ui theme), --html (self-contained HTML report), --brand-guide (brand guide PDF), --json-only, --save-output, --screenshot, --color-format, --raw-colors - Supports analysis flags: --wcag (contrast grades on real DOM pairs), --compare (drift gate, exits 1 when tokens moved), --tokens (check rendered values against a W3C Design Tokens file), --max-off-token, --tokens-report, --annotations, --approve, --ai (ML brand-primary prediction, experimental)
- Supports coverage flags: --crawl (merge N pages), --sitemap, --dark-mode, --mobile, --slow, --browser (chromium or firefox), --no-sandbox - Supports access flags: --cookie, --cookie-file, --basic-auth, --login, --save-storage-state, --header, --no-headed-fallback, --user-agent, --locale, --timezone, --accept-language, --screen-size, --stealth, --key - Provides an MCP server for AI agent integration (Claude Code, Cursor, Windsurf, etc.) with tools like get_design_tokens, get_color_palette, get_typography, etc.
- Includes a GitHub Action for CI drift detection:
dembrandt/[email protected]with url and baseline inputs.
Use cases
- Extracting design tokens from any website for documentation or migration.
- Enforcing design consistency in CI by comparing preview deployments against a committed baseline.
- Auditing WCAG 2.1 contrast on real DOM pairs.
- Generating design system tokens for Style Dictionary or Tokens Studio (via --dtcg).
- Creating brand guides (PDF) or design markdown for AI agents.
- Integrating with AI agents via MCP to extract design tokens programmatically.
Getting started
Install globally: bash npm install -g dembrandt dembrandt install-browser # one-time: fetches the matching Chromium dembrandt dembrandt.com Or use npx: bash npx dembrandt dembrandt.com Requires Node.js 18+.
License and pricing
License: MIT. Pricing: open source (free).
Based on the project's public README and repository metadata.