Integration
Integrazione
Import Your Figma File Into ComtraImporta il Tuo File Figma in Comtra
Connect one Figma file. Comtra reads its tokens and components, so the rest of the Hub knows your design system without you exporting a thing. Collega un file Figma. Comtra legge i suoi token e componenti, così il resto dell'Hub conosce il tuo design system senza che tu debba esportare nulla.
How it works Come funziona
- Connect via Figma OAuth sign-in, or save a Personal Access Token — both are supported. Collegati con il login OAuth di Figma, oppure salva un Personal Access Token — entrambi supportati.
- Comtra's plugin reads your file's design tokens and component structure and syncs them into the shared backend the whole Hub reads from. Il plugin Comtra legge i design token e la struttura dei componenti del tuo file e li sincronizza nel backend condiviso da cui legge tutto l'Hub.
✓ It's a file-keyed sync, not "connect your whole account" — you choose which file, and the plugin keeps its tokens and components in sync whenever you use it.
✓ È una sincronizzazione legata al singolo file, non "collega tutto il tuo account" — scegli tu quale file, e il plugin ne tiene sincronizzati token e componenti ogni volta che lo usi.
This is the same mechanism that powers Comtra's native design-system audit and AI generation in DS context — it's why Comtra is Figma-aware in the first place.
È lo stesso meccanismo che alimenta l'audit nativo del design system e la generazione AI nel contesto del DS — è per questo che Comtra è consapevole di Figma fin dall'inizio.
Objections & promises Obiezioni & promesse
| "I don't want to give Comtra full access to my Figma account." "Non voglio dare a Comtra accesso completo al mio account Figma." | You connect one file at a time via OAuth or a token you control — not blanket account access. Colleghi un file alla volta via OAuth o un token che controlli tu — non un accesso generale all'account. |
| "What if I stop using the plugin?" "Cosa succede se smetto di usare il plugin?" | Your Figma file is untouched — Comtra only reads, it doesn't write back to Figma. Il tuo file Figma resta intatto — Comtra legge soltanto, non scrive mai su Figma. |
| "Does this send my whole file, comments included?" "Questo invia tutto il file, commenti inclusi?" | No — by default only design tokens and component structure/context flow through, not comments or full file contents. If you want more than that, the Comtra plugin can pull it in via Figma Bridge or similar tools — you decide what to send. No — di default passano solo i design token e la struttura/contesto dei componenti, non i commenti o il contenuto completo del file. Se vuoi far passare di più, il plugin Comtra può farlo tramite Figma Bridge o strumenti simili — decidi tu cosa inviare. |
| "What about FigJam boards?" "E le board FigJam?" | Not synced automatically today. You can pull FigJam content in manually, or via MCP — a native connector for it is being evaluated. Non sono ancora sincronizzate automaticamente. Puoi estrarre il contenuto FigJam manualmente, o via MCP — un connettore nativo è in valutazione. |
What syncs Cosa viene sincronizzato
| WhatCosa | StatusStato |
|---|---|
| Design tokensDesign token | ✓ synced via the pluginsincronizzati via plugin |
| Component structure & contextStruttura & contesto dei componenti | ✓ synced via the pluginsincronizzati via plugin |
| Full file contentsContenuto completo del file | ✗ not needed — Comtra reads structure, not filesnon necessario — Comtra legge la struttura, non i file |
| FigJam boardsBoard FigJam | ◑ not automatic — manual or via MCPnon automatico — manuale o via MCP |
✓ synced · ✗ not included. This scope is intentional — Comtra reads only what a design system audit and AI generation actually need. ✓ sincronizzato · ✗ non incluso. Questo ambito è intenzionale — Comtra legge solo ciò che servono davvero l'audit del design system e la generazione AI.
Join the waitlist →
Unisciti alla waitlist →
Connect one file. Keep working in Figma. Collega un file. Continua a lavorare in Figma.
