Cross-project imports

Publishing a version of a Plasmic project enables you to reuse the components, styles, and images you’ve made in other projects. (Read more about publishing in general.)

How does it work?

  • Edit the components, tokens, icons, and other assets in your project.
  • When you’re ready to share your work, publish the project.
  • Everyone that has view access to your project can now import the assets and use them in other projects. Imported assets are read-only snapshots and listed in the corresponding left panels, such as the Components and Style Tokens panels.
  • You can continue to edit on your original upstream project without affecting the other downstream projects. Your edits will only become visible to others when you publish a new version. (All versions are visible in a detailed version history.)
  • Collaborators are notified of the new version and can choose to update their imports to the latest published version.

Rules for cross-project imports

  • Consistent versions for imported projects: If a project appears in multiple places in a dependency tree, then they must be at the same exact version number. This ensures that we have consistent designs across the project (e.g. all buttons in a page look the same).
  • Published versions share the same permissions as projects: Only collaborators with view-access to your project can import published versions.
  • No circular dependencies: If Project A depends on Project B, Project B cannot depend on Project A anywhere in its dependency tree.

Importing a project

Now that you’ve published a version, let’s navigate to another project that might want to use the published assets.

Imported assets will now show up along side your local assets, which can be used in your designs.

Updating imports

Project assets that you import will not change unless you explicitly update them. You can check for updates in the “Imported projects” left tab. When the project has a newer version available, you should see an alert icon next to the dependency.

Click on the alert icon to update to the newest version.