Skip to main content
The Humic plugin does two things. Pull brings your published tokens into the current Figma file as Variables. Push sends that file’s variables back to Humic as a draft.

​
Set up

  1. During private beta, import figma-plugin/manifest.json as a development plugin in Figma Desktop. The Community listing is not published until Figma assigns and Humic commits its numeric plugin id.
  2. Run it from Figma’s plugin menu.
  3. Click Connect with Humic and confirm in the browser tab that opens. The plugin picks it up on its own. A connection lasts 90 days.
  4. Click the design system name in the top bar to pick or switch design systems. Your choice is remembered.
The plugin needs a Humic account. Humic is in private beta and accounts are invite-only, so if the browser tab tells you your email doesn’t have access yet, join the waitlist at humic.dev and we’ll be in touch. You need edit access to the file’s variables, plus the editor role in Humic to push. Viewers can pull.

​
Pull

Pull serves the published version of your design system. An edit you have not published yet is invisible to Figma, and a design system that has never been published has nothing to pull.
  • Each Humic collection becomes one Figma Variable Collection with the same name.
  • Dots in a token name become folders: color.brand.primary becomes color / brand / primary.
  • Aliases stay aliases, across collections, so the next pull carries changes downstream.
  • Composite tokens (shadows, typography, gradients) arrive as Figma styles.
  • Modes come across as you set them up in Humic. On Figma’s free plan, which allows one mode per collection, a multi-mode collection is split into Collection · Mode.
  • Variables the plugin created that no longer exist in Humic are removed. Anything you made yourself in Figma is left alone.

​
Push

Push reads every collection in the file and lands it in Humic as a draft. Nothing reaches the API, the exports or anyone else’s Figma file until you publish it in Humic. New tokens arrive with No role, because Figma has no concept of a tier. Sort them in the token table using the No role assigned filter. Tokens that already have a role keep it, so re-pushing the same file never undoes your work.

​
Troubleshooting

  • “Publish this design system in Humic first.” Nothing has been published yet. Publish on the web, then pull.
  • I edited a token in Humic, but the plugin says we’re in sync. That edit is not published yet.
  • I pushed from Figma, but nothing changed anywhere. A push is a draft. Publish it in Humic.
  • “Your session expired.” Connections last 90 days. Reconnect from the plugin.