Troubleshooting
Common questions and quick fixes.
My login doesn't lead to the main screen
Screens need to be on the same page as the frame you convert, and at most twice as large or small; check the Screens card in Configure. If the button's label doesn't name a screen, tag it go: Main, or pick its target in the Screens card.
A popup never shows
Check that its button is named open: followed by the same name as the popup, and that the popup is a frame or group named popup: . The plugin's Checks list finds both mistakes.
A notification never shows
Check that the name you pass to notify( ) matches the one after notify: on the layer, and that the notification sits inside the screen you converted (not as its own top-level frame) and at the top of its layer list. The Elements tab lists every notification the conversion found.
Another page is blank
Pages without an assigned frame are blank on purpose. Assign a frame under Pages in the Configure step. The list only offers frames of about the same size as the one you converted.
A control looks right but doesn't react
Check that Animated controls is on in Configure, then look at the Elements tab after converting. If the control isn't listed, confirm it in What is this? before converting.
Something reacts that shouldn't
Rename it to static: … or choose Visual only for it in What is this?.
My close button doesn't close the app
It needs to sit along the top edge on the right and be 8 to 40 px. Name it close window, or use the plugin's Window tab, which checks the position.
A foreground looks washed out or covered
Check layer order in Figma: patterns, large gradients, and glows must sit below panels, controls, icons, and text.
An icon is missing
Make sure it's vector geometry, not a character from an icon font that isn't installed.
The file is rejected
Use File → Save local copy… in Figma Design. Renamed JSON files, FigJam files, and truncated downloads are rejected.