EA · Design system documentation
Quantum Portal: one source of truth for EA’s design system
The documentation home for Quantum, the design system over 15 EA teams use as the scaffolding for their projects, visited by hundreds of designers and developers across the company.
- Role
- Lead designer on the documentation site, contributing designer on the design system, front-end development support
- Scope
- Research through shipped code
- Team
- 30 designers, engineers, and product managers
- Timeline
- 3 months
Problem
EA’s design system was hard to use at scale.
I interviewed designers, developers, and project managers across the company in 30-minute sessions of about 15 questions, and three issues kept surfacing:
- No single source of truth. Designs lived across Sketch, Figma, Abstract, and InVision, and asking a design system designer was the fastest way to learn which version of a component was final.
- Almost no onboarding. New designers were overwhelmed and didn’t know where to start.
- Rework. Teams redid work after building on outdated components or guidance, which delayed timelines.
Solution
I led design of the Portal, a central internal site with guidelines, components, and implementations in one place.
-
Role-based onboarding.
The landing page splits into “getting started” paths for designers and engineers, each leading from principles and tooling (or tech stack and installation) into components and patterns.
Onboarding user flow -
A landing page for two audiences.
I explored layouts that encourage browsing while giving newcomers clear first steps, informed by a competitive analysis of well-regarded design systems of similar complexity.
Competitive analysis learnings
Landing page layout sketches -
Built with the system itself.
I composed the full-fidelity mocks from our own colors, text styles, patterns, and core components.
Full-fidelity mock, before the illustrations. -
Custom illustrations.
On my own initiative I replaced the planned component screenshots with hero illustrations tied to our brand team’s themes.
Illustrations for the Portal’s cards. -
A front end anyone could add to.
I supported front-end development. We built the Portal in React and TypeScript, and wrote its pages in MDX so they could be composed quickly and with limited code knowledge.
- React
- The site’s interface, built from components.
- TypeScript
- Typed code across the front end.
- MDX
- Markdown that can include React components. Pages are written as content, not code.
Impact
- Over 15 internal teams use Quantum as the scaffolding for their projects, with the Portal as its home.
- It gets visits from hundreds of designers and developers company-wide.
- Teams have praised its ease of use and the barriers it removed for first-time onboarding.
“Quantum made what would’ve been a multiple month process take days, with all components built to exacting standards. You can tell the team really understands what makes a good and flexible design system.”