This article is best for teams who would like to move existing Sketch Libraries into Abstract. Be sure to set some time aside to:
- Consolidate symbols
- Import your libraries
If you plan to use libraries, consider consolidating your symbols. You can consolidate your symbols into a single file or several files, based on your team's needs. These files will act as your source of truth for those symbols.
We've seen teams organize library files based on platform-specific assets, branding, and UI assets. If you're particularly happy with your symbol organization or are looking for recommendations, feel free to post in the Abstract Facebook or Spectrum groups.
Importing a Sketch Library into Abstract
If you've been using Sketch libraries outside of Abstract, set some time aside so you can tell Abstract where to find the new shared library symbols.
To import your library files:
- Select a project.
- Click Overview from the left-hand navigation.
- Click ADD FILES from the upper-right corner on the master card.
- Click Import Sketch File as Library...
- Name and create your new library file.
Additionally, you can use the ADD FILES button from any branch or master files list to import a library file.
Once you import the files (or replace the files), you'll have to manually replace the symbols so they reference the correct file.
When you import a library file into Abstract, we create a copy to store in Abstract. Anytime a copy of a file is created, it gets a fresh metadata assignment. Since the metadata changes, .sketch files you've used with the original library file will continue to reference that original library file—rather than the library file you've imported into Abstract.
Depending on how many symbols you previously referenced using Sketch Libraries without Abstract, it may take some time to complete this task. It is possible to use a third-party plugin—like Symbol Swapper—to help speed-up this process.
To manually replace a symbol:
- Click Edit in Sketch on a regular file
- In Sketch, select a symbol that referenced the original library file
- Go to File > Insert and select the symbol from the menu*
Replace the symbols until they've all been updated and reference the library file in Abstract rather than the original library file outside of Abstract.