2023-2024

Scaling a UI
Library

Scaling

a UI
Library

Bringing clarity and consistency to

clinician workflows

Bringing structure and speed to a growing tele-health platform

My Role

UX/UI Designer

Scope

Focused on auditing inconsistent UI patterns and building foundational components and responsive patterns to support a scalable system.

Team Allison Spillane (UI Designer), Sara Sailors (Engineering Lead) 

Year 2023-2024
Duration One Year

ClinicianConnect is a web-based telehealth platform developed at Health Recovery Solutions (HRS), supporting care teams in managing complex patient data. I worked on features used to triage cases, monitor vitals, and manage care workflows.

The Problem

The Problem

As the product scaled, features were shipped rapidly without a shared design system, leading to inconsistent UI patterns and duplicated components. For users managing high-stakes data, this fragmentation made workflows harder to navigate, increased the risk of error, and added rework for design and engineering teams.

KEY ISSUES

KEY ISSUES

Patterns fragmented as the product scaled without a shared system.

The Solution

The Solution

To improve development velocity and design consistency, my teammate and I partnered with engineering to build a scalable component library in Figma, aligning on naming conventions and implementation constraints from the start.


Rather than attempting to build a full design system upfront, the first phase focused on a structured, reusable foundation that could deliver immediate value while supporting future system growth.

To improve development velocity and design consistency, my teammate and I partnered with engineering to build a scalable component library in Figma, aligning on naming conventions and implementation constraints from the start.


Rather than attempting to build a full design system upfront, the first phase focused on a structured, reusable foundation that could deliver immediate value while supporting future system growth.

Exploring the
Interface

Exploring the
Interface

Starting with a full UI walkthrough of the product, the team and I noted interface patterns across key screens and what components were currently used.

Starting with a full UI walkthrough of the product, the team and I noted interface patterns across key screens and what components were currently used.

Key Observations

Key Observations

Different button styles, form labels, and modal behaviors had evolved without a shared structure. These variations made it difficult for users to predict system behavior and increased cognitive load for task completion.

Different button styles, form labels, and modal behaviors had evolved without a shared structure. These variations made it difficult for users to predict system behavior and increased cognitive load for task completion.

Observed Validation Variations

Audit: Validation States

Audit: Validation States

01

Default field

02

Required field + success feedback

03

Required field + success + help icon

04

Required field

Variability in input styling and validation states spotted across clinician workflows.

Defining the
Scope

Defining the
Scope

ClinicianConnect had widespread variation across UI patterns and interactions. Rather than building a full design system, I worked with the team to scope the work to what would create immediate impact, the answers led us to define a flexible, Figma-based UI Library grounded in four principles:

Prevent new UI variations across clinician workflows.

Reduce Variations

Designed to be lightweight and easy
to maintain .

Support a Small Team

Designed to scale across
clinician workflows

Build for Scale

Reduced rework with a shared starting point for design and engineering.

Increase Efficiency

Competitive
Analysis

While a mobile system existed, there was no shared system for the web platform, so I looked at established systems like Material and IBM Carbon to understand how mature systems structure components, documentation, and scalability. Rather than replicating them, we focused on identifying patterns that could introduce structure without over-engineering at our stage.

Material Design

What Works

  • Exceptional documentation

  • Beginner-friendly onboarding

  • Well-defined component anatomy

Where It Breaks Down

  • Can be overly prescriptive

  • Customization becomes harder without breaking key patterns

Design Takeaways
Borrow Material’s component structure and documentation patterns, while avoiding overly rigid constraints.

Material Design

What Works

  • Exceptional documentation

  • Beginner-friendly onboarding

  • Well-defined component anatomy

Where It Breaks Down

  • Can be overly prescriptive

  • Customization becomes harder without breaking key patterns

Design Takeaways
Borrow Material’s component structure and documentation patterns, while avoiding overly rigid constraints.

Carbon Design

What Works

  • Clear and minimal navigation

  • Documentation that supports scale

  • Defines accessibility user groups

Where It Breaks Down

  • Visual style can feel rigid

  • Extensive documentation can feel overwhelming at first

Design Takeaways
Start smaller to improve usability and maintainability, while building a flexible foundation for scale.

Carbon Design

What Works

  • Clear and minimal navigation

  • Documentation that supports scale

  • Defines accessibility user groups

Where It Breaks Down

  • Visual style can feel rigid

  • Extensive documentation can feel overwhelming at first

Design Takeaways
Start smaller to improve usability and maintainability, while building a flexible foundation for scale.

Comparative analysis informed a lightweight, scalable structure for the initial UI library.

UI Audit: Making

Sense of a Mess

UI Audit: Making

Sense of a Mess

Next, working with the team, I audited dozens of live screens, tagging UI components to create a clear inventory of patterns across the product.

Using Brad Frost’s atomic design principles, we audited live screens by tagging UI elements, creating a component inventory, identifying gaps needed to build a scalable system.

Documentation and Tagging

We cataloged and tagged every recurring UI element to understand what actually existed within the product.

Key Findings
• Documentation and tagging inconsistencies
• Multiple button styles without system
• No shared component documentation

What this uncovered

Inconsistent component implementations resulting in slower production and more design and tech debt.

Documentation and Tagging

Tagged recurring UI elements to create an inventory of existing components.

Button Inconsistency

3 distinct button styles

  • Primary actions

  • Secondary actions

  • Utility actions

Documentation Gap

No shared component definitions, engineers

relied on local 

implementations.

What this uncovered

Inconsistent component implementations slowed production and increased design and engineering debt across teams.

Using Brad Frost’s atomic design principles, we audited live screens by tagging UI elements, creating a component inventory, and identifying gaps needed to build a scalable system.

Building the System

Building the System

With the audit complete and findings in hand, I began building the Figma-based UI Kit using atomic design principles, starting small and prioritizing clarity, reusability, and accessibility so components could be integrated immediately as new workflows were introduced. This established consistent patterns that scaled across workflows and reduced redundant implementations.

Visual Foundations

Typography

ClinicianConnect

H1

22px/Semibold

ClinicianConnect

H2

16px/Bold

This UI Library was built to support
reusability across screens and teams

Body Paragraph

16px/Regular

Sizing and Spacing

All component sizing should be in multiples of 8px or 4px, 8px is preferable. Consistent, standard, and scalable.

Example: System modal with real-world copy

Icons

Icons used across core flows to reinforce actions and system states.

Colors

Colors used to support hierarchy, feedback, and interaction.

Accent and Functional Colors

Primary

Default

Hover

Selected

Success

Confirmed/Saved

Warning

Errors & Destructive

Danger

Errors & Destructive

Neutral System Colors

Active

Selected or Non-primary Elements

Disabled

Non-interactive, disabled states

Icons

Icons used across core flows to reinforce actions and system states.

Icons

Icons used across core flows to reinforce actions and system states.

Core Components

Input Fields

Input fields for text entry and validation.

Enabled

Text

Forgot Password?

Focused

|Text

Forgot Password?

Filled

●●●●●

Forgot Password?

Input stroke outlines and helper text colors are exaggerated for documentation clarity.

Buttons

Buttons across core flows (default and disabled states).

Primary

Secondary

Default

Button

Button

Disabled

Button

Button

Buttons

Buttons across core flows (default and disabled states).

Primary

Default

Button

Disabled

Button

Secondary

Default

Button

Disabled

Button

System in Context

System in Context

Standardized components applied to authentication workflows. The login card sits on a semi-transparent surface to separate it from the background.

Standardized components applied to authentication workflows. The login card sits on a semi-transparent surface to separate it from the background.

The

Outcome

The

Outcome

The library made UI behavior predictable across workflows and gave design and engineering a shared starting point. Instead of recreating components feature by feature, the team could build on a consistent foundation, reducing rework and speeding up iteration.

~30%

Faster design-to-development time

Cleaner handoffs, reduced rework, faster decisions.

(Estimated from reduced design iteration cycles)

BEFORE

Fragmented component patterns

  • Inconsistent borders and spacing

  • No shared validation pattern

  • Different interaction patterns for
    similar inputs

AFTER

Introduced a shared component system across clinician workflows.

INPUT FIELDS

TEXT AREA

40+

reusable components reduced variation across workflows

  • Consistent states across form components

  • Clear focus and validation feedback

  • Predictable dropdown interactions

TEXT AREA

What’s Next

What’s Next

Before wrapping up my contribution, I partnered with my team to define clear priorities for evolving our work towards a more scalable system. We decided upon the following:

Component Standardization

Align design and front-end components, define a semantic token structure, and consolidate variations to reduce duplication and overrides.

Promoting Internal Adoption

Create lightweight documentation and onboarding to encourage component-first thinking across teams.

Improve Accessibility

Formalize WCAG 2.1 AA standards, document focus states and validation patterns, and align UI decisions with healthcare compliance needs.

Component Standardization

Align design and front-end components, define a semantic token structure, and consolidate variations to reduce duplication and overrides.

Promoting Internal Adoption

Create lightweight documentation and onboarding to encourage component-first thinking across teams.

Improve Accessibility

Formalize WCAG 2.1 AA standards, document focus states and validation patterns, and align UI decisions with healthcare compliance needs.

Let's Make Something Clear.

wu.mlucy@gmail.com

© 2026, Lucy Wu. All rights reserved

Let's Make Something Clear.

wu.mlucy@gmail.com

© 2026, Lucy Wu. All rights reserved

Let's Make Something Clear.

wu.mlucy@gmail.com

© 2026, Lucy Wu. All rights reserved