Keep your projects consistent by importing one project’s design system to another project. Importing a project's library can bring in the assets, styles, components, pages, variables, and custom prefabs from the original project.

We recommend creating one "design system" project to be the source of truth imported into working project files.

Begin the import by clicking on the Import Library button (CMD + I).

From the Project drop down, select the project with the design system you'd like to import. While we recommend creating a design system specific file that can be imported into multiple projects, you can import from any project.

Once a project has been selected, all items from that project will be loaded into the Import Library popover.

You can choose to import full categories like assets, styles, components, pages, prefabs, global variables, or custom events by selecting them from the items list.

If you choose to import an item category, like assets, you can select which items from that category are imported. If the category is not selected for import, no items from that category will be imported.

Once you've selected the items you'd like to import, press the button and your import will begin. All items will be found in their respective homes in the new project (imported styles will be in the Styles Panel; imported components will be in the library, etc.)

When the time comes to update your design system, you'll want to make changes in the design system project, which we'll call Project A.

Once you've made changes to Project A, you'll need to open a file using the design system, which we'll call Project B, and reimport items from Project A. Follow the same process as the original import.

Each item (style, component, prefab, etc.) from Project A that has already been imported into Project B will be replaced with the updated version. Any new items from Project A will be imported as well.

You can make changes in Project B, but you cannot "push" changes to Project A.