figma weave storybook plugin sync fix

Syncing Figma Weave AI-generated UI components directly with the Storybook plugin can cause authentication errors, component parsing failures, or blank canvas previews. This usually occurs due to variant property mismatches or unpublished component nodes. Follow these steps to reconnect your Weave components to your Storybook instance seamlessly.

Quick checks

• Confirm that your Figma Weave subscription is active and has sufficient generation credits; if you see account payment flags, read our guide on Figma Weave billing errors.
• Verify that the Figma Weave service isn't currently down by reviewing Figma Weave down or unreachable.
• Make sure your Storybook access token has valid write permissions for your target design system repository.

1. Publish Weave components to your team library

The Storybook plugin cannot parse draft component nodes generated by Figma Weave on local canvases. Move the generated AI frame into a published library file and select Publish changes. Once published, copy the published component URL directly into Storybook's addon config.

2. Standardize component variant naming

Figma Weave AI may generate component variants with non-standard property strings (such as `State=Hover / Variant 2`). Storybook requires explicit key-value pairs (`State=Hover, Size=Large`). Select the generated component set, open the Variant properties panel, and clean up property metadata before triggering the sync.

3. Refresh plugin access token and OAuth session

Plugin token invalidation often happens when running AI generation scripts alongside third-party API webhooks. Open the Storybook plugin settings inside Figma, click Log Out, and authenticate again via your Storybook URL.

4. Re-generate frames if output contains corrupted nodes

If the Storybook addon returns a JSON parser error on specific components, Weave may have produced corrupted DOM nodes during generation. If the generation was interrupted mid-way, consult our steps on Figma Weave not generating to create a clean component set.

Still stuck?

If Storybook plugin sync issues persist across all files, try reinstalling the Storybook plugin or testing the sync in Figma's web browser client. Figma Weave Support is an independent troubleshooting resource and is not affiliated with Figma, Inc.