Team Libraries (Shared Libraries)

Topics Covered in This Figma Tutorial:

Publishing a Team Library, Using Components in a Team Library, Using Styles in a Team Library, Swapping Team Libraries

Exercise Preview

Exercise Overview

In this comprehensive exercise, you'll master one of Figma's most powerful features for design systems: team libraries. You'll learn to create reusable assets—including colors, text styles, and components—that can be shared seamlessly across multiple documents and team members. This capability is essential for maintaining design consistency at scale, whether you're working on a small team or managing enterprise-level design systems. By the end of this tutorial, you'll understand how to establish a single source of truth for your design assets, ensuring that updates propagate automatically across your entire design ecosystem.

Creating a Team Project & Importing Files

We'll begin by setting up the proper project structure and importing the necessary design files that will serve as our foundation.

1. In Figma, navigate to the homescreen (file browser) if you're not already there:

   • In the Desktop app: Click the Home tab (Mac users can also choose File > Open File Browser).
   • In the Web app: At the top left, click the Main menu button and choose Back to files.

2. Create a new Team project to organize our library files. On the left sidebar, hover over your team name and click the Plus(+) icon.

   

3. Name the new project Pulse and click Create project. Using descriptive project names helps maintain organization as your design system grows.

4. Import the necessary files by clicking Import file (located near the top right).

5. Navigate to Desktop > Class Files > Figma Class and select all three design files:

   • Select all files (Women.fig, Pulse Design System.fig, and Pulse Design System Alternate.fig) by clicking the first file, then Shift-clicking the last file.
   • Click Open to begin the upload process.
   • Once the upload completes, click Done.

6. Double-click on Pulse Design System to open it. This will be our primary design system file.

Looking at the Components & Styles

Before publishing our library, let's examine the design assets we'll be sharing. Understanding the structure of your design system is crucial for effective library management.

Team libraries represent a paradigm shift in how design teams collaborate. When properly implemented, they create a shared foundation that ensures consistency while enabling rapid iteration across multiple projects and team members. Updates to the original library automatically propagate to all connected files, eliminating the manual effort of maintaining design consistency.

1. Click in an empty area to ensure nothing is selected, allowing you to view the global styles.

2. In the Design panel on the right, observe the comprehensive style system we've established:

   • Text Styles for typography hierarchy • Color Styles for brand consistency • Effect Styles for shadows and other visual effects • Grid Styles for layout standardization

3. Switch to the Assets panel at the top of the left sidebar to view our component library.

4. Expand Local components, then Pulse Components to explore the reusable interface elements we've created. These components form the building blocks of our design system.

Publishing a Library

Publishing transforms your local design assets into a shared team resource. This process is where individual design work becomes a collaborative system.

IMPORTANT: Figma's library publishing capabilities vary by plan tier. Publishing styles is available to free Starter teams, but publishing components requires a Professional team, Education team, or Figma Organization. If you're using the free Starter plan, you'll be able to publish styles but not components. For professional design teams, the component publishing feature is essential for maintaining design system integrity.

1. Ensure nothing is selected by clicking in an empty area.
2. In the toolbar, locate the dropdown arrow next to the file name and click it.
3. From the dropdown menu, select Publish styles and components.
4. In the publishing dialog, verify that all assets are selected (they should be by default) and click Publish. Your design system is now available as a shared team resource.

Loading the Team Library into a Design File

Now we'll demonstrate how other team members can access and utilize your published library in their design work.

1. Navigate back to the file browser to open a different file:

   • In the Desktop app: Click the Home tab (Mac users can also choose File > Open File Browser).
   • In the Web app: At the top left, click the Main menu button and choose Back to files.
2. In the Pulse project, double-click Women to open it. This file will serve as our design implementation example.
3. Switch to the Assets panel at the top of the left sidebar.
4. Click the Team library button at the top right of the Assets panel.
5. Activate the library by clicking the toggle switch next to Pulse Design System.

6. Close the Libraries dialog to return to your design canvas.

Using Components in a Team Library

With library access established, let's implement shared components to see the power of centralized design assets in action.

1. In the Assets panel, expand Pulse Design System (our team library), then Pulse Components to reveal all available components from the shared library.

2. Drag the nav component to the top of the frame. Notice how it maintains all its original properties and styling.

3. Drag the footer component to the bottom of the frame. These components are now connected to the master library, meaning future updates will propagate automatically.

Using Styles in a Team Library

Text and color styles from team libraries ensure typographic and brand consistency across all your design work.

1. Select the New Autumn Attire text element and apply our shared typography system:

   • In the Design panel, click the Style button next to Text
   • Under Pulse Design System, select the Heading style to apply consistent typography.

2. Apply a consistent brand color by clicking the Style button next to Fill

   • Under Pulse Design System, select 3. Dark (dark brown). You may need to scroll if you're in list view.

3. Select the subheading text cozy women's styles for the fall season and establish hierarchy:

   • In the Design panel, click the Style button next to Text
   • Under Pulse Design System, apply the Subheading style.

4. Complete the styling by clicking the Style button next to Fill

   • Under Pulse Design System, select 2. Medium (medium brown) to create appropriate contrast hierarchy.

Updating a Team Library

One of the most powerful aspects of team libraries is the ability to make systematic updates that propagate across all connected files. Let's demonstrate this workflow.

1. In the Assets panel, Ctrl-click (Mac) or right-click (Windows) on the navbar component and choose Go to main component.

   This navigation feature takes you directly to the source component in the library file.

2. Click in an empty area to deselect all elements.
3. In the Design panel, locate the Text Styles section.
4. Hover over the Heading style and click the Edit Style button that appears.

5. In the Edit style panel, make these adjustments to improve the typography hierarchy:

   • Change the font weight from Regular to Black for stronger visual presence.
   • Increase the font size from 29 to 34 pixels for better readability.

6. Close the Edit style panel to apply your changes.

7. In the Pulse Components frame, double-click on the navbar's background to select it.

8. Update the navbar color to align with our brand palette:

   • In the Design panel, click the Style button next to Fill
   • Select 3. Dark (dark brown) to apply consistent brand colors.
9. Click in an empty area to deselect, then click once on the navbar to select the entire component.

10. Notice the Publish changes button in the Design panel—this indicates pending updates.

    • The black dot next to Assets in the left panel serves as an additional visual indicator of unpublished changes.
11. Switch to the Assets panel in the left sidebar.
12. Click the Team library button at the top right of the Assets panel.
13. Next to Pulse Design System, click the Publish 2 changes button.

14. Click Publish to propagate your updates across all connected files.

Accepting Library Changes in a File

When libraries are updated, consuming files receive notifications to review and accept changes. This controlled update process ensures teams can evaluate changes before implementation.

1. Return to the Women file to see how library updates are handled:

   • In the Desktop app: Click the Women tab at the top of the interface.
   • In the Web app: Click the Women—Figma browser tab.

2. Look for the Component updates available notification at the bottom right of the window and click Review.

   NOTE: If you dismiss this notification, you can access the same functionality through the Assets panel by clicking Team library and selecting Updates.

3. In the Updates window, review the proposed changes:

   • While you could update changes individually, click Update all to accept all modifications simultaneously.

4. Observe the results of your library updates:

   • The heading text now displays with black font weight and increased size for improved hierarchy.
   • The navbar background has changed to the brand-consistent brown color.

Optional Bonus: Swapping Team Libraries

Library swapping is an advanced technique that proves invaluable when managing multiple design system versions or transitioning between different brand guidelines. This capability is particularly useful for agencies managing multiple client brand systems or organizations maintaining separate libraries for different product lines.

To demonstrate this functionality, we'll first need to establish a second published library.

1. Navigate back to the file browser:

   • In the Desktop app: Click the Home tab (Mac users can also choose File > Open File Browser).
   • In the Web app: At the top left, click the Main menu button and choose Back to files.
2. In the Pulse project, double-click Pulse Design System Alternate to open the alternative design system.
3. Ensure nothing is selected by clicking in an empty area.
4. Access the publishing options by clicking the dropdown arrow next to the file name in the toolbar.
5. Select Publish styles and components from the menu.

6. Click Publish to make this alternative design system available as a team library.

7. Return to the Women file to perform the library swap:

   • In the Desktop app: Click the Women tab at the top.
   • In the Web app: Click the Main menu button and choose Back to files. Then double-click Women in the Pulse project.
8. Switch to the Assets panel at the top of the left sidebar.

9. Click the Team library button at the top right of the Assets panel.

10. Click on Pulse Design System (the currently active library) to access its options.
11. Select Swap library to begin the substitution process.
12. Click Choose library in the top right corner and select Pulse Design System Alternate. You may need to navigate into your team's submenu to locate it.
13. Click Swap library to execute the change.

14. Observe the dramatic transformation of your design as it adopts the alternative design system's styling and components.

    For comprehensive information about advanced library swapping techniques and best practices, visit tinyurl.com/fig-swap-lib