Current plugin version: v1.0

weableColor for Figma — Documentation

Product: weableColor for Figma
Last updated: 2026-05-20

Learn Mission Control, Live Inspector, contrast fixes, CSV export, Vision Simulator, and developer handoff for the weableColor Figma plugin.


Overview

weableColor for Figma helps design teams check and improve color contrast inside real Figma files — without exporting to another tool. You get a live accessibility score, layer-level WCAG and APCA (Lc) readouts, in-file fixes, CSV reports for QA and handoff, and optional color-vision simulation.

Who it's for: product designers, design systems leads, and accessibility champions who work in Figma daily.

What it's not: A legal WCAG audit certificate or a replacement for semantic/HTML accessibility testing. It focuses on color contrast in your Figma document.

Get the plugin: Figma Community (link at publish) · Support: support@weable.pro


Quick start

  1. Open the plugin from Plugins → weableColor.
  2. Wait for the Live Accessibility Score in Mission Control; the score is also echoed in the sticky header (page scope).
  3. Select a layer to score selection + descendants, or deselect for full-page scope.
  4. Scan Canvas anytime to refresh the current page.
  5. Expand Live Inspector rows to inspect pairs; use Analyze for fixes.
  6. Export Report after a scan to copy a CSV for Slack, email, or Sheets.

First win in 60 seconds: Select a button with low contrast → open its Inspector row → Apply a suggested fix → watch the score move.


Mission Control

Mission Control is your home base in the plugin.

UI elementPurpose
Score ring0–100 live score for current scope (page or selection)
IssuesCount + dropdown with quick actions and “View all in Inspector”
Scan CanvasRe-scans the current page (tooltip: “Scan current page”)
ExportCSV accessibility report (requires prior scan)
ShareTeam snapshot, developer snippet, email, Community link
⋯ MoreExport, Share, documentation, quick help, Vision Simulator, About

The sticky header stays visible while you scroll the panel so score and actions are always one tap away.


Scoring & scope

Page scope — No selection: score and Inspector reflect the current page.

Selection scope — With layers selected: score reflects the selection subtree (node + descendants).

Score meaning — Composite accessibility signal from analyzed text/background pairs in scope (not a legal compliance score). Re-scan after fixes to verify improvement.

WCAG contrast — Standard contrast ratios with AA / AAA pass indicators where applicable.

APCA — Perceptual contrast (Lc) when enabled in results — useful for modern contrast thinking beyond ratio-only checks.


Live Inspector

Live Inspector lists color elements in scope with contrast readouts and status.

Typical workflow:

  1. Sort/filter by severity (critical → minor) when available.
  2. Expand a row to see foreground/background, ratio, WCAG/APCA status.
  3. Use Get Fixes / suggested colors where offered.
  4. Open Analyze for the full modal: live preview, replacement swatches, apply to canvas.

Analyze modal (deep dive on one pair):

  • Live preview against background
  • Suggested replacements (shown when below target thresholds)
  • Apply updates fills and strokes in Figma
  • Follows canvas selection while open (select another layer to sync)
  • Undo with Figma’s native undo after apply (Cmd+Z / Ctrl+Z)

Generate & palettes

Generate (Mission Control) builds palette explorations from selected elements — harmonies and swatches before you commit.

Save Palette — Save named palettes from Generate previews when available.

Export palette JSON — Export palette data for design-system handoff (Mission Control palette tools).

Pair with the VS Code extension for code-side verification (see Developer handoff).


Fixes & remediation

Apply fix paths:

  • Sticky Issues dropdown → per-item suggested color
  • Inspector → Get Fixes drawer
  • Analyze modal → replacement swatches → Apply

Use Cmd+Z / Ctrl+Z in Figma to undo the last apply.

Fixes modify Figma paint on the canvas. Always verify visually and re-scan.

Pro tip: After a batch of fixes, run Scan Canvas and Export Report for a before/after paper trail.


Export & share

Export Report (CSV)

After a scan, Export Report copies a CSV with columns such as:

Layer/Screen Name, Type, Foreground, Background, Contrast Ratio, WCAG Pass/Fail, Status

Use for QA tickets, client deliverables, or design-dev handoff.

Share modal

OptionDeliverable
Copy scan summaryScore, issues line, scope, element count — paste into Slack/email
Copy developer snippetShort comment block + CSV preview rows
Email teamOpens mail with pre-filled summary
Copy plugin linkFigma Community listing (when live)

Share with Developer

Opens a modal with a longer developer snippet (palette + contrast notes) for VS Code workflows.


Vision Simulator

Simulate color vision deficiency (protanopia, deuteranopia, tritanopia, achromatopsia) on your current selection.

  1. Select frame or elements on canvas.
  2. ⋯ → Vision Simulator.
  3. Choose type; preview updates live.
  4. Generate in new artboard to duplicate with simulation applied (non-destructive to original until you choose).

Developer handoff

In Figma: Export CSV or Share → developer snippet.

In VS Code: Install @weable/a11y-color-utils for the same contrast logic in code (CI, themes, components).

npm package: @weable-tools/a11y-color-utils — see developer API docs.


License & plans

Free / trial includes Mission Control, Live Inspector, Generate, Fix, Vision Simulator, and Export (per in-plugin License modal).

Pro unlocks cross-tool workflow integration, team collaboration features, and advanced export/integration paths (see pricing).

Manage license: weable.pro/account.


Troubleshooting

  • Score not updating → run Scan Canvas or check selection vs page scope
  • Empty export → scan first, then export again
  • Vision Sim disabled → select layers on the canvas first
  • Esc closes modals; Cmd+Z / Ctrl+Z undoes last canvas apply
  • Plugin feels narrow → intentional; use this doc hub for long guides

Still stuck? support@weable.pro — include file name, scope (page vs selection), and steps to reproduce.


Privacy & data

The plugin analyzes document colors via the Figma plugin API. Refer to Privacy Policy and Terms on weable.pro. Do not paste confidential client data into support email beyond what’s needed to debug.


Changelog

VersionDateNotes
1.02026-05Modal UX: no layout shift, Esc dismiss, rounded share sheet
1.02026-05Analyze follows canvas selection; undo toast