Skip to content
Back to search

dembrandt

Extract any website’s design system into tokens in seconds: logo, colors, typography, borders & more. One command.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked yesterday

Check it deeper on your machine

It has changed since its scan on 19 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/dembrandt/dembrandt with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/dembrandt/dembrandt'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/dembrandt--dembrandt/badge.svg)](/listings/dembrandt--dembrandt)

HTML

<a href="/listings/dembrandt--dembrandt"><img src="/api/listings/dembrandt--dembrandt/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

npm install -g dembrandt
dembrandt install-browser        # one-time: fetches the matching Chromium
dembrandt dembrandt.com

The browser step is required. dembrandt drives Chromium through `playwright-core`, which ships no browser binaries, so a fresh install has nothing to launch until you run it. Skipping it fails with `browser engine not available`.

Or use npx without installing: `npx dembrandt dembrandt.com`. The browser step applies here too: run `npx dembrandt install-browser` first. Browsers land in a shared Playwright cache, so either route only needs it once.

Requires Node.js 18+

Or install the MCP server straight into your editor and let the agent run it:

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 242 lines
  1. # Dembrandt.
  2. [![npm version](https://img.shields.io/npm/v/dembrandt.svg)](https://www.npmjs.com/package/dembrandt)
  3. [![npm downloads](https://img.shields.io/npm/dm/dembrandt.svg)](https://www.npmjs.com/package/dembrandt)
  4. [![license](https://img.shields.io/npm/l/dembrandt.svg)](https://github.com/dembrandt/dembrandt/blob/main/LICENSE)
  5. [![GitHub Marketplace](https://img.shields.io/badge/GitHub%20Marketplace-Drift%20Gate-2088FF?logo=githubactions&logoColor=white)](https://github.com/marketplace/actions/dembrandt-drift-gate)
  6. [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-me-pink?style=flat&logo=github-sponsors)](https://github.com/sponsors/dembrandt)
  7. Extract any website's design system in one command. Enforce it in CI.
  8. Logo, colors, typography, spacing, borders, shadows, motion, components. W3C design tokens in seconds.
  9. ![Dembrandt: Any website to design tokens](https://raw.githubusercontent.com/dembrandt/dembrandt/main/docs/images/banner.png)
  10. ## Install
  11. ```bash
  12. npm install -g dembrandt
  13. dembrandt install-browser # one-time: fetches the matching Chromium
  14. dembrandt dembrandt.com
  15. ```
  16. The browser step is required. dembrandt drives Chromium through `playwright-core`,
  17. which ships no browser binaries, so a fresh install has nothing to launch until you
  18. run it. Skipping it fails with `browser engine not available`.
  19. Or use npx without installing: `npx dembrandt dembrandt.com`. The browser step applies
  20. here too: run `npx dembrandt install-browser` first. Browsers land in a shared
  21. Playwright cache, so either route only needs it once.
  22. Requires Node.js 18+
  23. Or install the MCP server straight into your editor and let the agent run it:
  24. [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=dembrandt&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRlbWJyYW5kdCIsIm1jcCJdfQ==)
  25. [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=dembrandt&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22dembrandt%22%2C%22mcp%22%5D%7D)
  26. ## What you get
  27. - Colors (semantic roles with the evidence behind each pick, curated palette, every detected colour, CSS variables, gradients)
  28. - Typography (fonts, sizes, weights, sources, font file URLs)
  29. - Spacing (margin/padding scales)
  30. - Borders (radius, widths, styles, colors)
  31. - Shadows
  32. - Motion (duration scale, easing curves, hover patterns per component type)
  33. - Components (buttons, badges, inputs, links)
  34. - Breakpoints
  35. - Icons & frameworks
  36. Playwright renders the page, dembrandt reads computed styles from the DOM, analyzes color usage and confidence, groups similar typography, detects spacing patterns, and returns design tokens.
  37. ## Flags
  38. ```bash
  39. dembrandt dembrandt.com --shadcn # shadcn/ui theme, observed slots only
  40. dembrandt dembrandt.com --dtcg # W3C design tokens, for Style Dictionary or Tokens Studio
  41. dembrandt dembrandt.com --wcag # WCAG 2.1 contrast on real DOM pairs
  42. ```
  43. Default is formatted terminal output only. Every flag below; the detailed
  44. reference is **[docs/usage.md](docs/usage.md)**.
  45. **Export**
  46. | Flag | What you get |
  47. |---|---|
  48. | `--dtcg` | W3C design tokens (DTCG) |
  49. | `--design-md` | DESIGN.md for AI agents |
  50. | `--tailwind [path]` | Tailwind v4 `@theme` CSS |
  51. | `--shadcn [path]` | shadcn/ui theme, observed slots only |
  52. | `--html [path]` | Self-contained HTML report |
  53. | `--brand-guide` | Brand guide PDF |
  54. | `--json-only` | Raw JSON to stdout |
  55. | `--save-output` | JSON to `output/<domain>/` |
  56. | `--screenshot <path>` | Viewport screenshot |
  57. | `--color-format <f>` | Colour notation: hex, rgb, oklch, lch, source |
  58. | `--raw-colors` | Pre-filter colours too |
  59. **Analysis**
  60. | Flag | What you get |
  61. |---|---|
  62. | `--wcag` | Contrast grades on real DOM pairs |
  63. | `--compare <baseline>` | Drift gate; exits 1 when tokens moved |
  64. | `--tokens <file>` | Check rendered colours, radii and font sizes against a W3C Design Tokens file; repeat for several |
  65. | `--max-off-token <n>` | With `--tokens`: exit 1 when more than N rendered values match no token |
  66. | `--tokens-report <path>` | With `--tokens`: Markdown summary with the nearest token per off-token value, wiki-ready |
  67. | `--annotations <github\|azure>` | CI annotations for drift and off-token values; detected from the runner by default |
  68. | `--approve` | Accept the current run as the new baseline |
  69. | `--ai` | ML brand-primary prediction (experimental) |
  70. **Coverage**
  71. | Flag | What you get |
  72. |---|---|
  73. | `--crawl [n]` | Merge N pages, cross-page confidence |
  74. | `--sitemap` | Discover pages from sitemap.xml |
  75. | `--dark-mode` | The dark theme's tokens |
  76. | `--mobile` | Mobile viewport |
  77. | `--slow` | 3x timeouts for heavy sites |
  78. | `--browser <type>` | chromium or firefox; CDP via env |
  79. | `--no-sandbox` | For Docker and CI |
  80. **Access**
  81. | Flag | What you get |
  82. |---|---|
  83. | `--cookie <string>` | Reach pages behind a session |
  84. | `--cookie-file <path>` | JSON cookies, Playwright storageState (incl. localStorage and the sessionStorage block `--save-storage-state` adds), or Netscape cookies.txt |
  85. | `--basic-auth <user:pass>` | HTTP Basic for the browser context |
  86. | `--login` | Open a visible browser to sign in; press Enter when ready, then extract (interactive terminal only) |
  87. | `--save-storage-state <path>` | With `--login`, save the signed-in session (cookies, localStorage, sessionStorage) to a file; reuse it later with `--cookie-file`, also in CI |
  88. | `--header <string>` | Any extra request header, repeat for several |
  89. | `--no-headed-fallback` | Never open a visible browser on a failed navigation; for batch runs |
  90. | `--user-agent <string>` | Custom user agent |
  91. | `--locale <string>` | Locale for the fingerprint |
  92. | `--timezone <string>` | Timezone for the fingerprint |
  93. | `--accept-language <s>` | Accept-Language header |
  94. | `--screen-size <WxH>` | Reported screen resolution |
  95. | `--stealth` | Anti-detection; authorized use only |
  96. | `--key <string>` | Sync runs to your account |
  97. ## Catch design drift in CI
  98. Extract a preview deployment, compare against a committed baseline, fail the job when tokens moved:
  99. ```yaml
  100. - uses: dembrandt/dembrandt@v0.40.2
  101. with:
  102. url: https://preview.example.com
  103. baseline: .dembrandt/baseline.json
  104. ```
  105. The action is on the [GitHub Marketplace](https://github.com/marketplace/actions/dembrandt-drift-gate) and annotates the PR with the drifted tokens. On any other runner the gate is just an exit code plus JSON: `dembrandt URL --compare baseline.json --json-only` exits 1 on drift and prints per-token `changes[]`. See **[docs/ci.md](docs/ci.md)** for the Action inputs, the platform-neutral gate, and the exit code table.
  106. ## Recipes
  107. Copy a command, paste a prompt, get a result. Competitor benchmarking, WCAG audits, Figma token push, agentic design system builds. Filterable by role at **[dembrandt.com/recipes](https://www.dembrandt.com/recipes)**, with the basics in [docs/recipes.md](docs/recipes.md).
  108. ## AI Agent Integration (MCP)
  109. Use Dembrandt as a tool in Claude Code, Cursor, Windsurf, or any MCP-compatible client. Ask your agent to "extract the color palette from dembrandt.com" and it calls Dembrandt automatically.
  110. [![Add to Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=dembrandt&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRlbWJyYW5kdCIsIm1jcCJdfQ==)
  111. [![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=for-the-badge&logo=visualstudiocode&logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=dembrandt&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22dembrandt%22%2C%22mcp%22%5D%7D)
  112. Per-client setup, environment variables and the full tool list: **[docs/mcp.md](docs/mcp.md)** and **[dembrandt.com/mcp](https://www.dembrandt.com/mcp)**.
  113. ```bash
  114. claude mcp add --transport stdio dembrandt -- npx -y dembrandt mcp
  115. ```
  116. The server is listed in the [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.dembrandt/dembrandt) as `io.github.dembrandt/dembrandt`, so a client that reads the registry can install it by name.
  117. Or add to your project's `.mcp.json`:
  118. ```json
  119. {
  120. "mcpServers": {
  121. "dembrandt": {
  122. "command": "npx",
  123. "args": ["-y", "dembrandt", "mcp"]
  124. }
  125. }
  126. }
  127. ```
  128. Available tools include `get_design_tokens`, `get_color_palette`, `get_typography`, `get_component_styles`, `get_surfaces`, `get_spacing`, and `get_brand_identity`, plus pure analysis tools (`compute_drift`, `get_findings`, `export_dtcg`, `generate_design_md`, `render_report`) and job-control tools.
  129. Extraction tools accept `slow`, `mobile`, `darkMode`, `wcag`, `cookie`, `cookieFile`, `basicAuth` and `header` (for authenticated pages), `userAgent`, and `noSandbox` (Docker and most CI containers). Interactive `--login` stays CLI-only. Set `pages` above 1 to crawl and merge several pages, which produces a markedly stronger token set than one page; `paths` names them explicitly and `sitemap` discovers them from sitemap.xml.
  130. Extraction returns a `job_id`. Wait on it with `get_job_status` and `wait_seconds`, then hand that same id to the pure tools instead of passing the extraction back as an argument. The status leaves the extraction out, since it runs to hundreds of kilobytes; `include_result: true` returns it:
  131. ```
  132. get_design_tokens(url: "example.com", pages: 5) -> job_id
  133. get_job_status(job_id, wait_seconds: 50) -> completed
  134. get_findings(job_id) -> contrast and consistency issues
  135. export_dtcg(job_id) -> W3C design tokens
  136. ```
  137. Pair with **[dembrandt-skills](https://github.com/dembrandt/dembrandt-skills)** to give your agent UX intelligence on top of extracted tokens: hierarchy, accessibility, interaction states, and a full 6-stage design pipeline orchestrator.
  138. ```bash
  139. npx skills add dembrandt/dembrandt-skills
  140. ```
  141. ## Dembrandt App (Beta)
  142. Load extractions, track token drift, and compare snapshots. **[dembrandt.com/app](https://www.dembrandt.com/app)**
  143. * **Automatic drift tracking from CI.** Generate an API key at [dembrandt.com/app/api-keys](https://www.dembrandt.com/app/api-keys), then pass `--key` to the CLI. Every run uploads a snapshot to your account and scores it against the previous one for that domain. Wire into GitHub Actions or any CI runner and every deploy records itself.
  144. * **Pin a baseline.** Mark any snapshot as your reference. Every subsequent extraction is automatically scored against it.
  145. * **Visual diff.** Color swatches, before/after values, delta scores per category: colors, typography, spacing, radius, shadows.
  146. * **Snapshot timeline.** Proportional timeline per domain, scrub across any date range from days to years.
  147. * **Compare side by side.** Load multiple extractions into one view: two releases, two sites, or two surfaces.
  148. * **Copy tokens.** Paste values straight into Copilot, Claude, or Cursor.
  149. * **No login required for local use.** Data stays in the browser. Sign in with GitHub to enable cloud sync.
  150. ## Limitations
  151. - Dark mode requires `--dark-mode` flag (not automatically detected)
  152. - Hover and focus states come from real interaction on a sample of elements; states that need a pointer path or a timer are missed
  153. - Canvas/WebGL-rendered sites cannot be analyzed (no DOM to read)
  154. - JavaScript-heavy sites require hydration time (8s initial + 4s stabilization)
  155. - Some dynamically-loaded content may be missed
  156. - Default viewport is 1920x1080 (use `--mobile` for 390x844 mobile viewport)
  157. ## Intended Use
  158. Dembrandt reads publicly available CSS and computed styles from website DOMs for documentation, learning, and analysis of design systems you own or have permission to analyze.
  159. Only run Dembrandt against sites whose Terms of Service permit automated access, or against your own properties. Do not use extracted material to reproduce third-party brand identities, logos, or trademarks. Respect robots.txt, rate limits, and copyright.
  160. Dembrandt does not host, redistribute, or claim rights to any third-party brand assets.
  161. ## Sponsors
  162. The CLI is MIT-licensed and free. Sponsorship funds the enforcement layer: a committed project-level token baseline, `--compare` and the ingest API for CI/CD drift gates, and the App platform (snapshot history, team drift dashboard, alerts to Slack, Linear, and GitHub).
  163. [![GitHub Sponsors](https://img.shields.io/badge/Sponsor-me-pink?style=flat&logo=github-sponsors)](https://github.com/sponsors/dembrandt)
  164. <!-- sponsors -->
  165. <!-- Backer ($25+) and Lead sponsor ($500+) logos appear here. -->
  166. <!-- sponsors -->
  167. ## Documentation
  168. - [docs/usage.md](docs/usage.md): every flag, multi-page extraction, browser selection, CDP, DTCG, DESIGN.md, Tailwind theme, WCAG, motion, brand guide PDF
  169. - [docs/ci.md](docs/ci.md): GitHub Action, drift gate, exit codes
  170. - [docs/mcp.md](docs/mcp.md): MCP server install per client, environment, tools
  171. - [docs/recipes.md](docs/recipes.md): copy-paste workflows
  172. - [docs/FLAGS.md](docs/FLAGS.md): flag interactions, ignored combinations, multi-page propagation
  173. ## Contributing
  174. Bugs, weird sites, pull requests. All welcome.
  175. Open an [Issue](https://github.com/dembrandt/dembrandt/issues) or PR.
  176. @thevangelist
  177. MIT. Do whatever you want with it.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.