figma-primitives
✦ Your Figma plugin starter pack

Build Figma
plugins faster.

A modern collection of typed primitives and utilities for plugin runtime, UI, and networking.

Start building →
TSRVOne small toolkit.
All the invisible plumbing.
BUILT FOR THE MODERN PLUGIN STACKTypeScriptReactViteFigma API
01 / THE TOOLKIT

Three layers.
One clear foundation.

Use only what you need. Every entry point is focused, typed, and designed to stay out of your product's way.

1/3
✦

Core
primitives.

Protocols, tasks, layers, selection, errors, and structured logging—without framework baggage.

  • Typed main ↔ UI messaging
  • Cancellable task lifecycles
  • Serializable layer inspection
figma-primitives
2/3
⚛

Built with
React.

Small, composable bindings that keep your UI predictable, responsive, and easy to maintain.

  • Task and selection hooks
  • Provider-based state
  • Tabs and layer pickers
figma-primitives/react
3/3
⌘

Threading &
networking.

Run work in the background and communicate across your plugin without freezing the experience.

  • Abortable JSON requests
  • Timeouts and decoders
  • Structured errors
createNetworkClient()
02 / ONE SHARED LANGUAGE

From canvas to UI,
everything connects.

Define your commands once. Keep state serializable. Let every task own its progress, cancellation, and outcome.

01◇
Figma canvasInspect layers and selection
02↔
Typed protocolSend safe request / response messages
03✓
Responsive UISubscribe to tasks, progress, and results
03 / QUICK START

Ready in one command.

Install the package, choose the entry points your plugin needs, and keep your product logic where it belongs: in your app.

Terminal
$ npm install figma-primitives

// Plugin runtime
import { createProtocol, createTaskEngine } from 'figma-primitives'

// Optional React UI
import { TaskProvider, useTasks } from 'figma-primitives/react'
✦

Spend less time on plumbing.
Build the plugin.

Small pieces. Explicit boundaries. A better starting point.

Explore on GitHub ↗Read the quick start
Copied to clipboard