Log in or create a free Rosenverse account to watch this video.
Log in Create free account100s of community videos are available to free members. Conference talks are generally available to Gold members.
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
-
•
Inconsistencies between design specs, Figma, Sketch, and code caused user confusion and mistrust of documentation.
-
•
Atlassian’s Constellation project aims to create a single source of truth unifying designer and developer documentation.
-
•
Live code examples embedded in documentation replace static images, ensuring up-to-date and interactive component previews.
-
•
Collaboration and early involvement between designers and engineers are critical to successful design system evolution.
-
•
The project spanned multiple years and team changes, requiring extensive documentation and ‘run books’ for onboarding.
-
•
Governance is framed as shared execution rather than policing, fostering buy-in instead of compliance tension.
-
•
Design tokens improve handoff accuracy, although integration with Figma is still partly manual and evolving.
-
•
Multiple local design systems coexist alongside the central system, typically as downstream consumers of core components.
-
•
Roadmap alignment between platform teams and product teams remains one of the biggest operational challenges.
-
•
Extensive user research including usability tests and tree card sorts informed navigation, IA, and content strategy.
Notable Quotes
"Kate considers live code to be the source of truth because she can’t trust the design site due to inconsistencies."
"If engineers don’t like what we’re doing, they absolutely will not adopt our design system."
"Governance shouldn’t be policing; we’re here to help create the best experience and save time."
"This project has a lot of history and required synthesizing findings from many people over years."
"Design systems reflect organizational structure – if designers and engineers are siloed, no tooling will fix that."
"Updating and adopting design system components requires company time and planning—for some teams, fast release cycles were too frequent to keep up."
"Docs as code is a philosophy that keeps documentation in workflows familiar to content designers and engineers alike."
"Prior prototypes and documentation of pain points helped pave the way and garner stakeholder buy-in for Constellation."
"We use MDX and markdown so designers can edit documentation directly through pull requests."
"Empathy on both sides is key—engineers need scoped work, designers need to understand engineering constraints."
Or choose a question:
More Videos
"Emotions are not universal at all; emotions and behaviors are constructed by the culture and society where they come from."
Verónica Urzúa Jorge MontielThe B-side of the Research Impact
March 12, 2021
"The software is so antiquated that operators barely have time to learn one system before moving to another with different UX."
Michal Anne RogondinoSaving Outer Space: The First UX Design System for Our Nation’s Satellites
January 8, 2024
"Better sharing the stories of those we seek to understand helps us lead with their truths."
Jemma AhmedTheme 2 Intro
March 10, 2022
"Ideas can come back around again and again. It’s not until they find a leader or strategic priority that they turn into more."
Kara KaneTheme One Intro
November 16, 2022
"Our career competencies are not a checklist or promotion; it's not an expectation that directs get excelling scores across their level to advance."
Laine Riley ProkayHow DesignOps can Drive Inclusive Career Ladders for All
September 30, 2021
"Most of what makes up meaningful human communication is harder for us to access screen to screen."
Laura Gatewood Laine ProkayBeyond Buzzwords: Adding Heart to Effective Slack Communication
September 23, 2024
"Working with other product designers as stakeholders lets you get to the point really quickly."
Caitlyn Hampton Monica Lee Jina YoonCompass 101: Growing Your Career In A Startup World
June 11, 2021
"Waves are happening on the fringes of society where cultural codes can be suspended and new social patterns develop."
Hana NagelTurning Research Ripples into Waves
November 8, 2018
"People and process design is as important as technology design in enterprise UX."
Alexandra SchmidtEnterprise UX Playbook (Videoconference)
December 1, 2022