A data source is a Figma file that has been added to Supernova to be used as a source for your design system content. The Figma file needs to be published as a library. From this source, you can import styles, components, assets and frames. It’s possible to add multiple data sources to one design system.
Data sources can be found in the Data Sources section of Supernova.
- In the Data Sources section, click New Data Source
- If it’s the first data source for your design system, enter a design system name
- Enter the URL of the Figma file you would like to add
- You can choose whether to enable automatic updates or not. If enabled, Supernova will regularly check for newly published updates in the data source file, and automatically import them.
- Select which design system content you want to import
- Click Import to complete. You can keep working or go to another part of the platform while your data is importing, and we'll let you know when it's done.
You can repeat this process to add multiple data sources to this design system.
It's also possible to add a data source that contains theme tokens. Theme tokens will be linked to tokens in your design system with matching names, and any extra tokens won't be imported.
If the data source contains theme tokens, you can select which theme you'd like to assign the tokens to.
If you enabled automatic updates, Supernova will regularly check for changes and update the design system automatically.
You can manually update the design system by clicking the Get All Updates button.
- In the Data Sources section, open the context menu for the relevant data source file
- Select Unlink source file from the menu
- In the dialog, type UNLINK to confirm
- Click Unlink to unlink your file
If you unlink a data source file, content imported from the file can no longer be updated. Different types of design system content will be affected in different ways:
- Tokens created from Figma styles imported from the data source will not be removed, but they can no longer be updated. They will be converted to their raw values.
- Components imported from the data source will not be removed, but will be unlinked and can no longer be updated. Components created within Supernova will not be affected.
- Frames imported from the data source used in documentation will not be removed, but will no longer be updated.
- Assets imported from the data source will be removed from your design system in Supernova and in documentation.