Rosenverse

Log in or create a free Rosenverse account to watch this video.

Log in Create free account

100s of community videos are available to free members. Conference talks are generally available to Gold members.

Building a New Home for the Atlassian Design System
Thursday, October 22, 2020 • Enterprise Community
Share the love for this talk
Building a New Home for the Atlassian Design System
Speakers: Charles Lee and Jennie Yip
Link:

Summary

Having a design system is a de facto necessity when building cohesive enterprise software. The challenge is how does it all come together with a single location, a source of truth, a website? How does a cross-functional team marshal the resources with political and technical willpower to achieve this goal? It’s no easy feat as Jennie Yip, Atlassian design systems lead, explains in this Medium essay. This fireside chat will dig deeper into the problems addressed and lessons learned, with Jennie and also Charles Lee, the engineering lead. Hearing their stories will inspire and inform all of us in our design system journeys. We hope you will join us!

Key Insights

  • Multiple sources of truth in design systems cause inconsistencies and confusion, as seen with the button component font weight differences across specs, design files, and code.

  • Design systems should treat code as the source of truth while making design tools like Figma an integrated extension of that truth.

  • The Constellation project aims to create a single, consistent destination for design and development documentation, consolidating 50+ guidelines and 27 out of 60 components.

  • Collaboration between designers and engineers early in the process is critical to align priorities, avoid scope creep, and build trust.

  • Governance in design systems works best as shared execution through community trust and enabling teams, rather than policing or harsh compliance enforcement.

  • Workshops and detailed documentation are essential for onboarding new team members quickly and preserving knowledge amid team changes.

  • Live code examples embedded in documentation reduce maintenance burdens and ensure consumers always see current component behavior.

  • Versioning pace needs balancing—too frequent releases burden product teams trying to keep up and can hinder adoption.

  • Research methods like card sorting and usability testing directly influence information architecture and navigation improvements in the new documentation.

  • Buy-in from leadership and stakeholders grew through repeated demos and a unified team vision, highlighting the value and reducing skepticism over time.

Notable Quotes

"We kept feeling the same consistent pain around some truths for our design system."

"Kate said she considers live code to be the source of truth because she can't trust the design site due to inconsistencies."

"Code is definitely considered the source of truth; we're working hard to make Figma an extension of that."

"Governance is not policing; we're here to help you create the best experience and save time."

"Workshops often reveal gaps in documentation, which is a spicy take but true."

"It's really about finding a way to link all the different aspects to bring everything together to tell the story."

"Continuous adaptation is key; you're adapting to the system as much as adopting it."

"If you can't get buy-in for collaboration between engineers and designers, start from the bottom and talk more early and often."

"Updating and adopting design system components is company time, so a slower release schedule helps teams keep up."

"We absolutely need feedback loops so engineers and designers can influence the design system and keep it relevant."

Ask the Rosenbot
Aditi Ruiz
Pulse Check: Empathy Mapping Your Product Manager, Pt. 2
2022 • Design in Product 2022
Gold
Joanna Vodopivec
One Research Team for All - Influence Without Authority
2022 • Advancing Research 2022
Gold
Harry Brignull
Beyond Clicks and Tricks: Why deceptive design has grown into a regulatory faultline
2026 • Rosenfeld Community
Jose Coronado
From Zero to Hero
2022 • DesignOps Summit 2022
Gold
Bria Alexander
Reflect and Chart Forward
2021 • Civic Design 2021
Gold
World Usability Day Panel Discussion
2022 • DesignOps Community
Andy Barraclough
From Costly Complexity to Efficient Insights: Why UX Teams Are Switching To Voxpopme
2024 • DesignOps Summit 2024
Gold
Matt Bernius
Trauma-informed Research: A Panel Discussion
2021 • Advancing Research Community
Patrick Commarford
Design Staffing for Impact
2024 • DesignOps Summit 2020
Gold
Indi Young
Paying Better Attention to the Problem with Indi Young
2019 • Advancing Research Community
Chloe Amos-Edkins
A Cultural Approach: Research in the Context of Glocalisation
2023 • Advancing Research 2023
Gold
Emily DiLeo
Stronger Together: Lessons Learned from UX Research Ops
2024 • DesignOps Summit 2024
Gold
Uday Gajendar
From AI to Zeitgeist: Theory as the design antidote to AI hype
2025 • Rosenfeld Community
Sam Proulx
Prototype Reviews, People With Disabilities, and You
2021 • Civic Design 2021
Gold
Jon White
Unsticking Research for Better Information Flow
2026 • Advancing Research 2026
Conference
Katie Johnson
Disrupting generative AI products with just-in-time consumer insights
2024 • Designing with AI 2024
Gold

More Videos

Giff Constable

"Plans tend to be worthless but the planning process is incredibly invaluable."

Giff Constable

Financial fluency for product leaders: AMA with Giff Constable

April 11, 2024

Kritika Yadav

"The AI assistant starts with reasoning and not results, engaging users in intelligent conversation to understand needs."

Kritika Yadav

Optimizing AI Conversations: A Case Study on Personalized Shopping Assistance Frameworks

June 10, 2025

Alla Weinberg

"Meetings tell us what kind of conversations we are having and what kind of conversations we are not having."

Alla Weinberg

How to Build and Scale Team Safety

January 8, 2024

Harry Brignull

"Everyone knew tech was changing the world and we all had this peak at how amazing the web was going to be."

Harry Brignull Mark Leiser Robert Stribley

Beyond Clicks and Tricks: Why deceptive design has grown into a regulatory faultline

January 16, 2026

Kit Unger

"Too often quality is the last priority and the first thing to go when teams are pressured to ship faster."

Kit Unger

Theme 2: Introduction

June 10, 2021

Sofia Quintero

"If you don’t have the time and organizational support, don’t do it because you only set a precedent of failure."

Sofia Quintero

Beyond Tools: The Messy Business of Implementing Research Repositories

March 10, 2022

Jeff Gothelf

"Calling it Lean UX might have limited its impact because people think UX is just for 'those people'."

Jeff Gothelf

The Intersection of Lean and Design

January 10, 2019

Kit Unger

"It can be very uncomfortable to be the only woman in that room."

Kit Unger Lada Gorlenko

Theme 3 Intro

June 10, 2022

Jorge Arango

"I resist premature optimization of tagging and structure; I want to be 80% there rather than perfect and distracted."

Jorge Arango

The Best of Both Worlds: How to Integrate Paper and Digital Notes (1st of 3 seminars)

April 5, 2024