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
Matt LeMay
You Don’t “Get” Anyone to Do Anything
2022 • Design in Product 2022
Gold
Ian Swinson
Designing and Driving UX Careers
2016 • Enterprise UX 2016
Gold
James Lang
If you can design an app, you can design a community
2025 • Rosenfeld Community
Liam Thurston
Why Your Design Team Is Quitting, And How To Fix It
2022 • Design at Scale 2022
Gold
Patrizia Bertini
The (r)evolution of designOps: It’s Time to Think (really) BIG
2025 • DesignOps Summit 2025
Gold
Savannah Carlin
Don't botch the bot: Designing interactions for AI
2024 • Designing with AI 2024
Gold
Ebru Namaldi
Designing the Designer’s Journey: Scaling Teams, Culture, and Growth Through DesignOps
2025 • DesignOps Summit 2025
Gold
Christian Bason
Expand—Rethinking Design for Public Challenges
2022 • Civic Design Community
Maggie Dieringer
Cutting through the Noise
2020 • DesignOps Community
Husani Oakley
Theme Three Intro
2023 • Enterprise UX 2023
Gold
Jilanna Wilson
Distributed Design Operations Management
2019 • DesignOps Summit 2019
Gold
Denise Jacobs
Interactive Keynote: Social Change by Design
2024 • Enterprise Experience 2020
Gold
Ari Zelmanow
Dark Side of Democratization
2023 • Advancing Research Community
Joe Meersman
Use AI to Drive Outcomes that Go Beyond the Design Sprint
2024 • DesignOps Summit 2024
Gold
Isaac Heyveld
Expand DesignOps Leadership as a Chief of Staff
2022 • DesignOps Summit 2022
Gold
Husani Oakley
Bias Towards Action: Building Teams that Build Work
2018 • Enterprise Experience 2018
Gold

More Videos

Louis Rosenfeld

"Sponsor sessions are not sales pitches, they’re people like you, really knowledgeable, sharing great things."

Louis Rosenfeld

Welcome / Housekeeping

June 6, 2023

Paul Pangaro, PhD

"You have to be responsible for your viewpoint—you can't claim objectivity and ignore the impact."

Paul Pangaro, PhD

Systems Disciplines: Table Stakes for 21st Century Organizations

June 6, 2023

Dharani Perera

"Often we’re seen just as people who create personas or blueprints, but that’s not even what’s needed."

Dharani Perera

The mandala of service design: unlocking alignment and action through service design

November 20, 2025

Tiffany Cheng

"Done is better than perfect. You can always refine afterwards."

Tiffany Cheng

Designing in a Pandemic: Integrating Speed and Rigor

June 9, 2022

Ricardo Martins

"Conjoint analysis reveals how consumers make choices by examining trade-offs they are willing to make."

Ricardo Martins

Unlocking the power of advanced quantitative methods

March 12, 2025

William Newton

"Executives first want to know what metric you will impact next quarter before approving big initiatives."

William Newton Jenny Chang

How to Lead With Data, and Without Data

June 7, 2023

Sahibzada Mayed

"If you walk in someone else’s shoes, then you’ve taken their shoes."

Sahibzada Mayed

The Politics of Radical Research: A Manifesto

March 27, 2023

Prayag Narula

"The best teams I know are a quarter ahead of the product roadmap, seeking out impactful strategic research projects themselves."

Prayag Narula

How to Empower Your Designers to Do Good Research – And Why You Want To

June 10, 2022

Jack Behar

"You can’t just break apart these components and type; instead, you change their properties to adjust labels, colors, or icons."

Jack Behar

How to Build Prototypes that Behave like an End-Product

December 6, 2022