Install
Install the Figma plugin
The Mestra plugin runs inside Figma. This page covers the install, sign-in and updates.
In the plugin, brands are called Centres and flagged formats are marked Needs a look. On the web they are Brands and To check. They are the same things.
Requirements
| Item | What you need |
|---|---|
| Figma | The Figma desktop app (current version). |
| Mestra account | An organisation, with you as an editor or owner. A reviewer can’t connect apps. |
| The plugin | From the Figma Community. Or the file mestra-figma.zip from the Mestra web app. |
| Network | Access to https://app.withmestra.com. The plugin contacts only that address. |
Install
Mestra is in the Figma Community.
- In the Figma desktop app, find Mestra in the Figma Community and select Install. Or choose Plugins → Manage plugins and search for it.
- Open Plugins → Mestra.
As an alternative, you can install the plugin from a file. In the Mestra web app, open Organisation > Apps and select Download for Figma (.zip). Anyone in your organisation can download it. The page shows the current version. Unzip the file. In the Figma desktop app, choose Plugins → Development → Import plugin from manifest and select the manifest.json from the unzipped folder. Then open Plugins → Development → Mestra.
Sign in
- In the plugin, press Sign in.
- The plugin shows Your code and opens your browser at the Mestra Connect page. If the browser can’t open, the plugin shows a link to open yourself.
- Check that the code matches. Choose your organisation, then press Allow.
- The plugin shows Signed in as your name and organisation.
The code lasts 10 minutes. If it expires, sign in again. Sign out in the plugin revokes the sign-in.
File link
This part describes plugin 1.8.0.
Mestra’s run page can open each brand’s section and each size’s frame in your Figma file. To do that, it needs the file’s link. Figma doesn’t always give the plugin the file’s key. When it doesn’t, a File link row shows under Master in the plugin.
- In Figma, choose Share → Copy link.
- In the plugin, paste it into the File link box (“Paste from Share → Copy link”) and select Save.
The plugin asks once for each file. The row then goes away. “Not a Figma file link” means the pasted text isn’t a link to a Figma file. The row never stops Generate. Without a link, the run still builds, and the run page just has no Open in Figma link for it.
Permissions
| Permission | Why |
|---|---|
Network to https://app.withmestra.com only |
Mestra plans layouts with its own service, where you also sign in. Nothing else is contacted. |
| Document access (dynamic-page) | To read your master and build the new frames in your file |
Owners can see and sign out every Figma sign-in on the Apps page in the web app. Everyone else sees only their own.
Updating
Figma updates the plugin from the Community. If you installed from a file, we email organisation owners when a new version is available. Download the new zip from the Apps page, then install the new file the same way.
Troubleshooting
| Symptom | Cause | Fix |
|---|---|---|
| “Your role (reviewer) can’t connect apps.” | You’re a reviewer in that organisation. | Ask an owner to change your role. See Invite your team. |
| “The code expired. Sign in again.” | The 10-minute code ran out. | Press Sign in again. |
| “Sign-in was cancelled in the browser.” | Cancel was pressed on the Connect page. | Press Sign in and choose Allow. |
| “You’re signed out. Sign in again.” | The sign-in was revoked or ended. | Press Sign in again. |
| “Couldn’t sign in. Try again.” | The sign-in didn’t complete. | Try again. If it keeps happening, contact Support. |
Still stuck? See Troubleshooting or Support.