Introduction to Tode SDK
Tode is the easiest way to add analytics for Figma plugins and widgets. Track user interactions, measure engagement, and understand how designers use your plugin all with just a few lines of code.
Why Tode?
Building a successful Figma plugin requires understanding your users. Tode provides powerful analytics for Figma plugins that help you:
- Track user actions - Know which features are used most
- Automatic session tracking - Session duration is tracked automatically, no configuration needed
- Capture custom metrics - Track any numeric value you need
- Analyze by country - See where your users are located
Quick Overview
Tode provides native adapters for all popular frameworks used in Figma plugin and widget development:
| Package | Description |
|---|---|
@tode-sdk/core | Core SDK - required for all integrations |
@tode-sdk/figma-react | React hook for plugin UI |
@tode-sdk/figma-vue | Vue composable for plugin UI |
@tode-sdk/figma-angular | Angular service for plugin UI |
@tode-sdk/figma-svelte | Svelte store for plugin UI |
@tode-sdk/figma-vanilla | Vanilla JS/TS for any framework |
Installation
Choose the adapter that matches your Figma plugin UI framework:
# React
npm install @tode-sdk/core @tode-sdk/figma-react
# Vue
npm install @tode-sdk/core @tode-sdk/figma-vue
# Angular
npm install @tode-sdk/core @tode-sdk/figma-angular
# Svelte
npm install @tode-sdk/core @tode-sdk/figma-svelte
# Vanilla JS/TS
npm install @tode-sdk/core @tode-sdk/figma-vanillaPrivacy and Security
What the SDK sends with each event, so you can describe it in your own privacy notice:
- The
actionNameand optional metric value you pass in figma.currentUser.idwhen your manifest requests identity access (used to count unique users), otherwise an empty value- Editor type, plugin mode and API version from the Figma runtime
- A country code derived from the request IP; the IP itself is not stored
- Session duration from the WebSocket connection
Tode never reads document contents, file names or layer data. Traffic is encrypted over HTTPS/WSS, events are deleted after your plan's retention window, and nothing is shared with third parties.
Next Steps
Ready to add analytics to your Figma plugin? Choose your framework guide:
- React Guide - Most popular for Figma plugins
- Vue Guide - Great for Vue-based UIs
- Angular Guide - For Angular applications
- Svelte Guide - Lightweight and fast
- Vanilla JS Guide - Framework-agnostic option
Or jump straight to the API Reference to see all available methods.