Figma Integration Guide
What the Figma integration does
With Figma connected, Nakama shows your team's projects and files (with live thumbnails) in their own panel. Clicking a file opens it full-size in Figma in your browser; each file's comment feed lives right in the panel — read threads, reply, filter to comments that mention you, and turn any comment into a todo.
Adding the app (connect)
1. Open the Nakama side panel in Chrome.
2. Press the + (Add) button at the bottom of the right-hand rail to open the Marketplace.
3. Choose Figma and press Connect.
4. A Figma sign-in page opens as a browser tab. Sign in and press Allow to authorize Nakama.
5. One-time setup: paste your Figma team URL (open your team on figma.com and copy the address bar) — the Figma API has no "list my teams", so Nakama asks once.
6. A Figma icon appears in the Nakama rail and the panel opens with your projects.
Using the app
Browse projects. The panel title is a project picker — switch projects from the dropdown.
Open files. Each file shows its thumbnail, name and last-modified time. Click it and the file opens in Figma in a browser tab — Nakama never tries to run Figma inside the panel.
Follow comments. Press the comment button on a file for its feed: threads grouped, unresolved first, with an @me filter for comments that mention you. New comments stream in while the feed is open.
Reply and act. Write replies right in the panel; hover a comment to add it to your Todo list. Drag a file card onto Slack or Telegram to share its link.
Permissions and data handling
Nakama requests the Figma scopes files:read (projects, files, comments) and file_comments:write (posting replies). Your Figma token is stored only in your browser's local extension storage and never on Nakama's servers; the app secret stays server-side for the OAuth exchange only.
Removing the app (disconnect)
In Nakama: press + (Add) in the rail to open the Marketplace, find Figma (shown as Connected) and press it to disconnect. The icon leaves the rail and the stored token is deleted from your browser.
In Figma: you can also revoke access under Figma Settings → Connected apps, which revokes it on Figma's side.
Troubleshooting
"That doesn't look like a team URL": the team URL must contain /team/<number>/ — open your team in figma.com's file browser and copy the full address.
Anything else: see the Help Center or email help@rexplore.xyz.