File Doctor｜Library, Component & Style Usage Scanner

About this plugin

File Doctor helps you discover external library usage, group findings by library, and quickly select usages to fix inconsistencies or migrate to target libraries.

## Features

- **Multi-scope scanning**: Scan current Selection, This Page, or the entire Document.

- **Components**: Detect instances from external libraries; view counts and select all usages.

- **Styles**: Includes Fill, Stroke, and Effect styles with visual previews where possible.

- **Text Styles**: Lists text styles and lets you select usages.

- **Variables (color and more)**: Detects variable bindings, resolves alias chains, shows collection/mode where available, and previews color variables.

- **Numbers (unlinked values)**: Surfaces common numeric properties (e.g., radius, spacing, size, opacity, stroke weight) that aren’t linked to styles/variables.

- **Grouping by library**: Results are grouped by library. A synthetic group for **Not in target library** highlights items not present in your configured libraries.

- **Quick selection tools**: Click any item to select all its usages; group-level selection is supported.

- **Filters**: Styles tab includes quick filters (Frame Fill, Text Fill, Shape Fill, Stroke, Effect). Numbers can be filtered by category.

- **Settings modal**:

- Configure your **Figma API Token** (stored locally via `figma.clientStorage`).

- Manage **Target Libraries** (multiple file keys/URLs supported).

- Toggle **Auto‑refresh libraries** before scans.

- Handy link to open Figma **Account settings** to manage tokens.

## Getting Started

1. Open File Doctor in Figma.

2. If prompted, open Settings and set your **Figma API Token**:

- Click “Open Account settings” to go to Figma’s settings page (`Help and account → Account settings`) and create a Personal Access Token.

- Paste the token into the plugin and Save.

3. (Optional) Add one or more **Target Library** file URLs/keys to enable library grouping and “Not in target library” comparisons.

4. Choose a scan mode and run a scan:

- Selection, This Page, or Full Document.

5. Explore results using tabs (Components, Styles, Numbers, Text Styles), apply filters, and click items to select their usages.

Notes:

- A token is required to resolve target library keys/names and for enhanced variable data; core scanning still works without it.

- Your token is stored locally using Figma’s client storage and is only used for direct Figma API calls.