Skip to main content

Install the plugin

1

Open Figma

Open the Figma desktop app or web app and open any design file.
2

Install LintKit

Go to Plugins > Community, search for LintKit, and click Install.Or open the LintKit plugin listing directly.
3

Run the plugin

Right-click the canvas, select Plugins > LintKit, or go to Plugins > LintKit > Open LintKit from the menu bar.

Understand the plugin layout

LintKit plugin overview showing the four main areas When LintKit opens, you see four main areas:
  1. Left Navigation Tabs — categories like Styles, Values, Components, Structure, Naming, and Accessibility. Click a tab to see findings for that category only.
  2. Findings list — each finding describes one inconsistency, grouped by rule. Click a finding to select the affected layers on the canvas.
  3. Settings and Docs — access rule configuration and documentation from the bottom of the navigation rail.
  4. Inspector Panel — when you click a finding, a detail panel opens on the right showing the finding summary, affected nodes, and available fixes.
The plugin adapts to your window size. Resize it wider to see the full navigation rail, or keep it narrow for a compact view. See Compact view for details.

Run your first scan

LintKit scans the current page automatically when it opens. You don’t need to click anything. After the scan completes, you see: LintKit scan results showing findings grouped by rule with severity badges
  1. Severity selector — filter findings by error (red), warning (yellow), or info (blue)
  2. Rule violation row — each finding describes one inconsistency, grouped by rule (e.g., “Fills without styles”)
  3. Node count per finding — shows how many layers are affected by each rule violation
LintKit scans the current page by default. Hidden and locked layers are skipped unless you enable them in configuration.

Scanning a selection

To scan only specific layers instead of the whole page:
  1. Select one or more layers on the canvas
  2. LintKit automatically re-scans your selection
  3. Findings update to show only what’s relevant to the selected layers
Selecting different frames and watching findings update automatically

Explore findings

Click any finding in the results list to:
  1. Select the affected layers on the canvas — LintKit highlights them so you can see exactly where the problem is
  2. Open the inspector — a detail panel showing the finding’s summary, affected node count, and available fixes
  3. Navigate between nodes — if the finding affects multiple layers, click individual nodes in the inspector to jump between them
Use Shift+click to select multiple findings. This is useful for reviewing a group of related findings before deciding how to fix them.

Fix a finding

Once you’ve selected a finding, the inspector shows your fix options: Clicking a finding, reviewing the suggestion, and applying a fix
1

Review the suggested fix

Most findings include a primary suggested fix. For example, an orphaned fill might suggest “Map to Primary/Blue” — the closest matching style in your file.Some findings offer multiple fix options. For example, an orphaned fill might let you map to a style, bind to a variable, or create a new style.
2

Choose the scope

Apply the fix to:
  • This instance — fix just the selected node
  • All in this finding — fix every node grouped under this finding
3

Apply the fix

Click the fix button. LintKit applies the change and removes the finding from the results.Every fix is a separate undo step in Figma. Press Ctrl+Z (or Cmd+Z on Mac) to undo immediately.

Fix confidence

Not all findings can be auto-fixed with equal safety. LintKit shows a confidence level:
ConfidenceMeaningExample
High (auto-fixable)Safe to apply — changes a single property without side effectsSnapping padding from 7px to 8px in auto-layout
Medium (review suggested)Likely correct but could affect layoutChanging element width or height
Low (manual fix)LintKit can’t auto-fix safely — provides instructions insteadAdjusting gaps between layers in a freeform frame
Three findings showing different fix confidence levels: auto-fixable, review suggested, and manual fix

Ignoring findings

If a finding is intentional (for example, a one-off spacing exception), click Ignore to dismiss it. Ignored findings:
  • Persist across scans
  • Can be scoped to the file (everyone sees it ignored) or just you (personal), depending on your configuration
  • Can be shown as dimmed results if you enable Show ignored in results in settings

Configure for your team

The default settings work well for general use. For tighter enforcement, configure LintKit to match your design system:
1

Open settings

Click the Settings tab in the plugin’s navigation.Settings panel showing library management and integration options
  1. Settings tabs — switch between rule configuration, integrations, and other options
  2. External library manager — manage which design libraries LintKit uses for color matching and style suggestions
Library loading can take a minute for large libraries with many styles and components.
2

Set your spacing scale

If your team uses an 8px spacing grid, enter your allowed values (e.g., 0, 4, 8, 16, 24, 32, 48, 64) and enable the Spacing Scale rule.
3

Set your corner radii

Enter the corner radius values your design system uses (e.g., 0, 4, 8, 16) and enable the Corner Radii rule.
4

Connect your tokens (optional)

If your team uses Tokens Studio or stores tokens in GitHub, connect them in the Integrations section to auto-configure spacing, radii, and color rules. See Tokens Studio or GitHub for setup.
See Configuration for a full guide to every setting.

Category navigation

Navigation tabs showing Overview, Styles, Values, Components, Structure, Naming, and Accessibility categories Use the navigation tabs on the left to filter findings by category. Each tab shows findings from related rules — for example, the Styles tab shows orphaned fills, strokes, text, effects, and grids.

Compact view

LintKit adapts to narrow plugin windows with a compact layout that works on smaller screens. LintKit in compact view showing the findings list and inspector panel side by side The left shows the compact findings list, and the right shows the inspector panel when you tap a finding. All fix capabilities remain available regardless of window size. See Compact view for details.

What’s next?