Packages

CLI · @justdraw/cli

v0.3.2 · npm install @justdraw/cli

Export pipeline for CI. Validates icons, generates optimized SVG and AVD XML, deploys to GitHub Pages. Single file, 161KB, zero runtime dependencies. Auto-installed into icon repos on first Cmd+S save from the editor.

Commands:

Command Purpose
justdraw validate . Quality gate — naming, empty paths, complexity, bounds, metadata
justdraw lint . Consistency linter — weight, grid, stray points
justdraw export . --out dist Optimize SVGs, generate AVD XML, build browse + changelog pages
justdraw npm-gen dist Tree-shakeable ESM package with TypeScript declarations
justdraw spm-gen dist Swift Package with IconView SwiftUI component
justdraw gradle-gen dist Gradle package with R.drawable references
justdraw framework-gen dist React, Vue, Svelte, React Native, Web Components
justdraw iconify-gen dist Iconify-compatible JSON
justdraw token list Semantic token management (list, add, remove, remap, import, validate)
justdraw registry lookup home Concept registry — lookup, resolve, search across 140K+ concepts
justdraw notify dist Slack/Discord webhook on publish

Also generates: DESIGN-SYSTEM.md, llms.txt, CONTRIBUTING.md.

MCP Server · @justdraw/mcp

v0.1.0 · npm install @justdraw/mcp

Model Context Protocol server for AI agents. 21 tools, 2 resources, 4 prompts. Taxonomy search, tag/category suggestions, quality validation, style matching, semantic token resolution, and a concept registry with stable IC-NNNNNN IDs across 167 icon sets.

Tools by category:

Category Tools
Search search_icons, lookup_icon, icons_by_category, find_universal_icons
Suggestions suggest_tags, suggest_category, validate_name
Quality validate_set, find_gaps
Style matching match_icon, rank_sets
Concept registry registry_lookup, registry_resolve, registry_search
Semantic tokens resolve_token, list_tokens
Metadata list_categories, taxonomy_stats

Resources: justdraw://taxonomy, justdraw://taxonomy/categories

Usage:

npx @justdraw/mcp                          # stdio transport
npx @justdraw/mcp --taxonomy path/to/data  # custom taxonomy path
npx @justdraw/mcp --repo path/to/icon-repo # point at a repo

Consumer SDK

Not yet published as a standalone package. Available as createIconSet() in src/core/sdk/.

import { createIconSet } from '@justdraw/sdk'
const icons = createIconSet('https://user.github.io/icons')

const svg = await icons.icon('arrow-right')   // fetch SVG string
const results = icons.search('arrow')          // search by name/tag
await icons.preload(['home', 'search', 'menu']) // prefetch batch
icons.injectIcons(document)                     // populate [data-icon] elements

Manifest caching with TTL. SVG caching. Concurrent request deduplication.

Dynamic Render API

Server-side SVG transform proxy on Vercel.

/api/render/{owner}/{repo}/{icon}?color=FF0000&sz=24&dl=1

Fetches SVG from GitHub Pages CDN, applies color and size transforms, returns with cache headers. Input validation: hex color, size 1–1024, path traversal protection.

VS Code Extension · justdraw-icons

v0.1.0 · Not yet published.

Icon picker panel inside VS Code. Search by name or tag, preview SVGs, copy import statement or raw SVG string. Semantic token search and display. Works with any published JustDraw set. Instrumented for demand intelligence (search/filter/inspect/insert signals).

Figma Plugin · @justdraw/figma-plugin

v0.1.0 · Not yet published.

Sync icons from CDN into Figma components. Mono icons use surgical vectorPaths swap — preserves instance overrides so consumers control color. Color icons use full node replacement — JustDraw owns the palette. New icons auto-categorized into frames from metadata. Token data stored in pluginData.

CDN Worker · @justdraw/cdn-worker

v0.1.0 · Not yet deployed.

Cloudflare reverse proxy at cdn.justdraw.dev → GitHub Pages. Adds CORS headers, caching, llms.txt and robots.txt for AI crawlers. Demand signal collection endpoints (POST /signals ingest, GET /demand read).

WhatTheIcon · @justdraw/match-site

Visual icon search. Drop an SVG to identify which icon set it belongs to.

Icon Registry · @justdraw/icon-registry

v0.1.0 · Not yet published.

Concept registry build tools. 140,608 concepts with stable IC-NNNNNN IDs across 167 icon sets, organized into 21 semantic blocks. Powers the taxonomy engine, MCP concept tools, and cross-set concept resolution.

Architecture

Editor → GitHub → CLI (GitHub Actions) → CDN (GitHub Pages)
                                          ↓
VS Code ←————————————————— MCP Server → AI agents
Figma  ←———— sync ————→ GitHub
CDN Worker → cdn.justdraw.dev
WhatTheIcon ← fingerprint index