Rosenverse
Building a New Home for the Atlassian Design System

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
Cennydd Bowles
Day 1 Panel
2024 • Designing with AI 2024
Gold
Louis Rosenfeld
Discussion: What Operations can teach DesignOps
2017 • DesignOps Summit 2017
Gold
Sarah Rink
Remote User Research: Dos and Don'ts from the Virtual Field
2020 • Advancing Research Community
Greg Petroff
Exit Interview #1: Greg Petroff: From Silicon Valley Executive to Sonoma County Possibilitarian
2025 • Rosenfeld Community
Wyatt Hayman
Global Research Panels
2020 • DesignOps Community
Sarah Williams
A Framework for CX Transformation
2021 • Design at Scale 2021
Gold
Amy Thibodeau
Opening Keynote: Process and Ambiguity
2019 • DesignOps Summit 2019
Gold
Mujtaba Hameed
The new horizon of ethnography: using AI to unlock the full potential of in-person research
2026 • Advancing Research 2026
Gold
Ian Swinson
Designing and Driving UX Careers
2016 • Enterprise UX 2016
Gold
Ana Maria Montero Barrantes
The Authentic UX Talent Show
2024 • Enterprise Experience 2020
Gold
Andy Polaine
What is the role of service design in product-led organizations?
2024 • Advancing Service Design 2024
Gold
Randolph Duke II
War Stories LIVE! Randy Duke II
2020 • Advancing Research 2020
Gold
Maria Rosala
Research Repositories
2026 • Advancing Research 2026
Gold
James Rampton
The Basics of Automotive UX & Why Phones Are a Part of That Future
2024 • Rosenfeld Community
Bria Alexander
Opening Remarks
2021 • Design at Scale 2021
Gold
Etienne Fang
The Power of Care: From Human-Centered Research to Humanity-Centered Leadership
2021 • Advancing Research 2021
Gold

More Videos

Louis Rosenfeld

"Manuel Herrera, our sketch noter, has contributed wonderfully to visually capturing the spirit and content of the conference."

Louis Rosenfeld Bria Alexander

Day 1 Welcome

September 23, 2024

Lisa Gironda

"I am the shock absorber for everything that’s happening so my boss can focus on bigger priorities."

Lisa Gironda

Opener: Chief of Staff–An unexpected journey

January 8, 2024

Jamie Beck Alexander

"We are talking about climate solutions to displace things that are incompatible with thriving life, not just add more options."

Jamie Beck Alexander Nina Gregg Shawn Petersen Bill DeRouchey

How can you find your role in climate?

January 17, 2024

Iram Shah

"Intelligence is the pursuit of knowledge; wisdom is the pursuit of truth."

Iram Shah

Closing Keynote: The View from the Top

June 4, 2019

Melinda Belcher

"Flexibility goes both ways: consultants must adapt to the client’s way, but clients must allow consultants to bring new approaches."

Melinda Belcher

Insider preview of Enterprise Experience 2020

May 28, 2020

Natalia Radywyl

"Sovereignty was never ceded."

Natalia Radywyl

Co-Designing New Power in Australia's Public Sector

November 16, 2022

Uday Gajendar

"To do this work, you can’t do it with a JIRA ticket."

Uday Gajendar

The Rise of Meta-Design: A Starter Playbook

May 19, 2022

Jesse Zolna

"Non-researchers often think you can just jump in and start asking questions, but that can be inefficient or risky."

Jesse Zolna

Inviting the Whole Org to Come See For Yourself

March 30, 2020

Steve Baty

"I prefer techniques where individuals generate ideas quietly first, so their train of thought isn’t lost in group dynamics."

Steve Baty Richard Dalton Maria Giudice Harry Max

Discussion

June 9, 2016