Team Library 1.0

Rasmus Andersson
Figma Design
Published in
5 min readSep 19, 2017
Illustration made for Figma by Peter Barnaba

We’re excited to announce Team Library 1.0, which empowers teams to create, use and maintain design systems. We introduced the beta version in February, and since then we’ve talked to hundreds of people about how they’re adopting it. We evolved the functionality based on feedback, and with today’s launch, we hope to make it easier for a wide range of teams to build their own design systems.

Components — buttons, icons, dialogs and whathaveyou — play a crucial role in many companies’ design systems. Organizations need the ability to share these elements widely across files and with team members. That way everyone can design in a structured manner and stay up-to-date with projects. Several companies have even gone to the extreme of developing their own tooling for this part of their design system. For instance, Airbnb and Facebook have hired experts to maintain and create such internal software.

We believe component sharing is key to design at scale, so we prioritized it in our product roadmap and released our Team Library beta way back in February. That was mere months after Figma launched to the public. Since then, many companies have used the feature to design in more consistent and efficient ways, and their insights helped guide our development process for the 1.0 version.

Since Figma is online and centralized, we believe we’re uniquely suited to help teams systematize their design. All projects and documents stay up to date in one place without exporting, syncing or sharing. A Figma Team Library is a single source of truth, forming the key foundation for a stable and living design system.

With Figma you can stop:

  • Syncing with third-party cloud services just to use your team’s component library
  • Praying nothing goes wrong with all the tools you’ve hacked together to use your company’s design system
  • Hunting down the right component like you’re starring in the world’s worst detective series

When you publish or make changes to a shared component in Figma, you can trust that everyone instantly sees the new component in the Team Library. You’ll also receive a notification when anyone else updates a component in another file, and you can decide whether to apply the changes to your own instances.

Before and after: The Team Library evolution

We launched our beta as a bare bones feature, with the goal of studying our users to understand what they most needed. We soon realized that even for a beta version, our original Team Library was too simple. In fact, it was quite limiting for the people pushing the boundaries of design systems.

Team Library UI

Old: In our beta, you’d have to use a pop-up again and again to browse for the components you needed. If that wasn’t tedious enough, the pop up also hid your canvas, so you couldn’t make fast iterations on your design. The UI clunkiness slowed the design process to an unbearable crawl.

New: Now all your team’s components are available directly beside your design, in a new tab in the left-hand sidebar where you work with your layers. When you need an instance of a component, simply drag it from the sidebar into your design.

Tip: Quickly switch left-hand sidebar tabs with alt+1 … 3

Additionally in that left-hand sidebar, there’s a third tab where you can see an overview of your local components. That makes publishing them to your Team Library easier because you’re able to see exactly what will show up in your library before publishing some changes.

Documentation

Old: Designers need ways to communicate component behavior, so their teammates know when, why and how to use specific elements. In our beta version, we had no place for documentation, so that kind of information wound up stranded in Slack or buried in Google Docs instead of where it should be — tied to the component itself.

New: Now with a component selected, you can add information about it in the right-hand properties panel. Teammates can then view the component documentation you created when they browse components in the Team Library.

Categorization

Old: A key part of a functioning design system is organization. Our beta version of Team Library only allowed categorization of components by file, so things got messy.

Categorize by frame and group in Team Library 1.0

New: Now you can see your components organized by group and frame in the Team Library in addition to file. For instance if you collect all your button components in a group and name it “Buttons,” you’ll see the thumbnails appear together under “Buttons” in both the Components and Team Library tabs of the left-hand sidebar.

Tip: Set the background of a shared component by changing the containing frame’s background color

Learn more

If you’re curious to learn more about Team Library and the new sidebar tabs, we’ve prepared this video that walks through everything in detail as well as this help center article outlining everything you need to know. If you’re new to components or want to learn more about them, have a look at this article from when we first launched our component feature.

As design becomes more integrated into companies large and small, the need for communication and formalization of design process has grown rapidly. We hope Team Library 1.0 will help teams with the collaborative nature of building cohesive products at scale.

A big thanks to everyone who supported us through this feature development cycle— your feedback inspired and defined our 1.0 vision.

--

--