eslint-plugin-figma-plugins

This repository defines typescript-eslint rules for Figma plugin development.

This tool helps you stay up to date with best practices and deprecations in the Figma Plugin API. You can use it to help identify, and in many cases automatically fix, issues in your plugin code. Like any ESLint plugin, it integrates with IDEs like VSCode to provide inline warnings and quick-fix functionality.

A quick look

Installation

Dependencies

This linter requires TypeScript, ESLint, typescript-eslint, and the Figma Plugin API type definitions. To install all of these, run:

npm install -D typescript eslint @figma/plugin-typings

For ESLint 8 with legacy config:

npm install -D eslint@8 @typescript-eslint/parser@8 @typescript-eslint/eslint-plugin@8

For ESLint 9 with flat config:

npm install -D eslint@9 @typescript-eslint/parser@8 @typescript-eslint/eslint-plugin@8  typescript-eslint@8

The default Figma plugin template uses older versions of these dependencies, so you may need to edit package.json manually to get more recent versions. We have tested flat config specifically with the following peer dependencies:

- `@typescript-eslint/eslint-plugin`: `8.48.1`
- `@typescript-eslint/parser`: `^8.48.1`
- `eslint`: `^9.39.1`
- `typescript-eslint`: `^8.48.1`

Install the ESLint plugin package

npm install -D @figma/eslint-plugin-figma-plugins

Configure eslint

Choose the configuration method based on your ESLint version:

ESLint 9+ (Flat Config)

Update your ESLint config to include the eslint-plugin-figma-plugins by creating an eslint.config.mjs file utilizing the new defineConfig() function (documentation is here: https://typescript-eslint.io/getting-started/#details)

Here's an example eslint.config.mjs that enables the recommended ruleset for this plugin, as well as the recommended rulesets from the @eslint/js and typescript-eslint packages:

import js from '@eslint/js';
import tseslint from 'typescript-eslint';
import * as figmaPlugin from '@figma/eslint-plugin-figma-plugins';
import { defineConfig } from 'eslint/config'

export default defineConfig(
  js.configs.recommended,
  tseslint.configs.recommended,
  {
    files: ['**/*.ts'],
    languageOptions: {
      parser: tseslint.parser,
      parserOptions: {
        project: './tsconfig.json',
      },
    },
    plugins: {
      '@figma/figma-plugins': figmaPlugin,
    },
    rules: {
      ...figmaPlugin.flatConfigs.recommended.rules,
    },
  }
);

ESLint 8 (Legacy Config)

Configure typescript-eslint as normal using these instructions.

Next, update your ESLint config's extends array to include the plugin:@figma/figma-plugins/recommended ruleset. We also recommend the following rulesets:

• eslint:recommended,
• plugin:@typescript-eslint/recommended

To work with TypeScript code, ESLint also requires the following parser settings:

{
  ...
  parser: '@typescript-eslint/parser',
  parserOptions: {
    project: './tsconfig.json',
  },
  ...
}

Here's a full example of .eslintrc.js:

/* eslint-env node */
module.exports = {
  extends: [
    'eslint:recommended',
    'plugin:@typescript-eslint/recommended',
    'plugin:@figma/figma-plugins/recommended',
  ],
  parser: '@typescript-eslint/parser',
  parserOptions: {
    project: './tsconfig.json',
  },
  root: true
}

Restart the ESLint server

If you've run npm install and updated to a newer version of this package, remember to restart your IDE. In VSCode, you can restart the ESLint server independently by opening the command palette and choosing "Restart ESLint Server".

Usage

Linting and autofixing

You can lint your project using these rules by running

npx eslint ./path/to/source

Some rules provide autofixes, which you can run using --fix.

npx eslint --fix ./path/to/source

Autofixes are also available via some IDEs.

VSCode

To use ESLint with VSCode, see the ESLint VSCode extension. This extension will show rule violations inline, as well as provide opportunities to run autofixes directly in the IDE.

Available Configurations

This plugin provides two configurations:

• recommended: Includes all rules - errors for breaking changes and warnings for advisories
• recommended-problems-only: Only includes error-level rules for breaking changes, omitting warnings

For flat config, use:

• figmaPlugin.flatConfigs.recommended
• figmaPlugin.flatConfigs['recommended-problems-only']

For legacy config, use:

• plugin:@figma/figma-plugins/recommended
• plugin:@figma/figma-plugins/recommended-problems-only

Rules

💼 Configurations enabled in.
⚠️ Configurations set to warn in.
👍 Set in the recommended configuration.
🔦 Set in the recommended-problems-only configuration.
🔧 Automatically fixable by the --fix CLI option.

Name	Description	💼	⚠️	🔧
await-requires-async	Require functions that contain await to be async	👍 🔦		🔧
ban-deprecated-id-params	Ban use of deprecated string ID parameters	👍 🔦		🔧
ban-deprecated-sync-methods	Ban use of deprecated synchronous methods	👍 🔦		🔧
ban-deprecated-sync-prop-getters	Ban use of deprecated synchronous property getters	👍 🔦		🔧
ban-deprecated-sync-prop-setters	Ban use of deprecated synchronous property getters	👍 🔦		🔧
constrain-proportions-replaced-by-target-aspect-ratio-advice	Warns against using constrainProportions in favor of targetAspectRatio		👍
dynamic-page-documentchange-event-advice	Advice on using the documentchange event		👍
dynamic-page-find-method-advice	Advice on using the find*() family of methods		👍

Contributing

Please see CONTRIBUTING.md