Sorb.For youHow it worksFeaturesPricingDocsStart free — public betaSign in

Troubleshooting

The most common issues during the beta come down to three things: the bridge isn't running, the URLs don't match, or preview mode isn't enabled. Work through these first.

The plugin can't reach the bridge

  • Confirm sorb dev is running and note the origin it prints (default http://localhost:7777).
  • In the plugin's Settings, make sure Bridge origin matches exactly — including http:// and the port.
  • The bridge binds to 127.0.0.1 and rejects cross-site writes by design. If you're connecting from a hosted setup, use an org key instead of a local origin (see Cloud & accounts).

Preview doesn't appear in my app

  • Preview mode is off by default in @sorb/leaf. Enable it and allowlist the bridge origin you're previewing from.
  • Check the App URL in Settings points at your running dev server (e.g. http://localhost:5173).
  • Make sure your app is actually wrapped in SorbProvider.

Tokens don't bind to the right property

  • Binding is by type and affinity — fills → background, strokes → border, text → text color, radius → corner. If a value lands on the wrong property, check its type in the token source.
  • Invalid values are rejected before they're applied (a color that isn't hex/rgb/hsl, a dimension without a unit). A rejected value shows a red border in the Tokens table and is never written.

Figma changed but the table didn't update

  • If you have an unsaved edit, auto-sync is held back to avoid clobbering it — a "Figma changed — Refresh" link appears instead. Click it to pull the latest.
  • Auto-sync can be toggled in the Tokens view; it's on by default.

Storybook inserts look wrong

  • Fonts fall back to a system font if the captured font isn't available in the file.
  • Very large captured trees fall back to a type-initial thumbnail; the insert itself still materializes the full node tree.

Org key won't connect

  • The key must be a valid sorb_pk_… organization publishable key from your dashboard.
  • Confirm your account is active and the org exists. See Cloud & accounts.

Still stuck?

Reach the team through the support form or email contact@sorbcloud.com. Because this is a beta, please include what you were doing, the plugin view, and any error text.

Works with Figma. Not affiliated with, or endorsed by, Figma. Figma is a trademark of Figma, Inc.