2022-2023

Scaling a UI
Library

Stabilizing a fragmented UI foundation
for clinician workflows

2022-2023

Scaling a UI Library

Stabilizing a fragmented UI foundation
for clinician workflows

2022-2023

Scaling

a UI
Library

Stabilizing a fragmented UI foundation for clinician workflows

Role

Product Designer (UX/UI Designer)

Scope

Built foundational UI components in Figma and audited key clinician workflows, creating 40+ reusable components that reduced design-to-development time by ~30%.

Built foundational UI components in Figma and audited key clinician workflows, creating 40+ reusable components that reduced design-to-development time by ~30%.

Team

Me — Foundational UI components, UI audit
Allison Spillane — Mobile & advanced components
Sara Sailors — Engineering Lead

Year

2022-2023

Duration

One Year

ClinicianConnect

ClinicianConnect

At Health Recovery Solutions (HRS), I helped standardize ClinicianConnect, a telehealth platform that helps clinical teams manage complex patient data.

At Health Recovery Solutions (HRS), I helped standardize ClinicianConnect, a telehealth platform that helps clinical teams manage complex patient data.

The Problem

As the platform grew, UI variations accumulated across components and interactions. Without a shared foundation, clinicians encountered a less predictable interface, while design and engineering faced ongoing rework.

WHERE IT BROKE DOWN

Clinicians needed predictable interaction patterns to move quickly between fields and assign patients.

Patterns fragmented as the product scaled without a shared system.

WHERE IT BROKE DOWN

Clinicians needed predictable interaction patterns to move quickly between fields and assign patients.

The Solution

To improve design consistency and development velocity, I partnered with a teammate and engineering to build a scalable component library in Figma.

Rather than building a full design system upfront, we focused on foundational components that delivered immediate value and could scale over time, with naming conventions and implementation constraints aligned on from the start.

01

01

01

Defining
the Scope

ClinicianConnect had grown without a shared inventory of UI patterns, creating variation across workflows as the platform evolved. Because product direction was still evolving, introducing new components too early risked reinforcing patterns that might later change. The team and I decided to first document and structure existing UI patterns, creating a stable foundation before standardizing components.

Stabilize Before Standardizing

We prioritized consistency across workflows before introducing new component patterns.

Cleaner Handoffs

A shared source of truth reduced implementation ambiguity and back-and-forth.

Defining the
Scope

Stabilize Before Standardizing

We prioritized consistency across workflows before introducing new component patterns.

Cleaner Handoffs

A shared source of truth reduced implementation ambiguity and

back-and-forth.

02

02

02

Mapping
the Interface

I then conducted a UI walkthrough across key workflows, documenting interface patterns and identifying component variations. Different button styles, form labels, and modal behaviors had evolved independently, increasing cognitive load and reducing predictability.

I then conducted a UI walkthrough across key workflows, documenting interface patterns and identifying component variations. Different button styles, form labels, and modal behaviors had evolved independently, increasing cognitive load and reducing predictability.

Observed Variations

Audit: Validation States

Audit: Validation States

01

Default field

02

Required field + success feedback

03

Required field + success + help icon

04

Required field

03

03

03

Competitive
Analysis

Without an existing design system for the web platform, each team member independently evaluated Material Design and IBM Carbon to understand how mature systems organize components and documentation. After regrouping, we identified principles for a scalable UI library structure that supported the evolving product roadmap without overbuilding the system prematurely.

Competitive
Analysis

Material Design

What Works

  • Exceptional documentation

  • Beginner-friendly onboarding

  • Well-defined component anatomy

Where It Breaks Down

  • Can be overly prescriptive

  • Customization can break patterns

Design Takeaways

Borrow strong structure without rigid documentation constraints.

Material Design

What Works

  • Exceptional documentation

  • Beginner-friendly onboarding

  • Well-defined component anatomy

Where It Breaks Down

  • Can be overly prescriptive

  • Customization can break patterns

Design Takeaways

Borrow strong structure without rigid documentation 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

  • Documentation can overwhelming

Design Takeaways

Start small to improve maintainability, while building flexibility 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

  • Documentation can overwhelming

Design Takeaways

Start small to improve maintainability, while building flexibility for scale.

04

04

04

Audit:
UI Patterns

Next, I organized ClinicianConnect into key workflows and audited dozens of live screens, tagging UI components and inconsistencies across the product. The team consolidated the findings into a shared inventory that became the blueprint for the initial UI kit.

What this Uncovered

The audit surfaced dozens of near-duplicate components, each solving the same problem differently, across key clinician workflows.

What this Uncovered

The audit surfaced dozens of near-duplicate components, each solving the same problem differently, across key clinician workflows.

What this Uncovered

The audit surfaced dozens of near-duplicate components, each solving the same problem differently, across key clinician workflows.

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.

Patient Inventory Dashboard

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

Pattern Mapping

Tagging recurring UI elements across workflows to understand platform structure.

Missing Standards

No shared component definitions led teams to rely on local implementations.

Button Patterns

Primary, secondary, and utility actions varied across workflows.

Modal Patterns

Confirmation flows varied across workflows and lacked predictable behavior.

Modal Variations Across Workflows

05

05

05

Building
the System

With the inventory complete, I started building the core components for the team’s UI kit. Following atomic design principles, I began with typography and spacing before moving into higher-variation interactive components. Along the way, I documented accessibility issues including missing focus states and insufficient color contrast.

I also co-developed a presentation for engineering and product teams, showing how consolidating component variations could reduce duplicate work over time.

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.

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

40+

reusable components reduced variation across workflows

  • Consistent states across form components

  • Clear focus and validation feedback

  • Predictable dropdown interactions

  • Consistent states across form components

  • Clear focus and validation feedback

  • Predictable dropdown interactions

The
Outcome

The library became a shared source of truth for new feature work, making it easier for design and engineering to identify reusable patterns, reduce rework, and accelerate iteration.

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.

Introduced a shared component system across clinician workflows.

INPUT FIELDS

TEXT AREA

TEXT AREA

~30%

Faster

design-to-development

time

Cleaner handoffs, reduced rework, faster decisions.

(Estimated from reduced design iteration cycles)

(Estimated from reduced design iteration cycles)

~30%


Faster

design-to-development

time

Cleaner handoffs, reduced rework, faster decisions.

(Estimated from reduced design iteration cycles)

What’s Next

Before wrapping up my contribution, three priorities were identified for evolving the library into a more scalable system:

Component Standardization

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

Reinforce Internal Adoption

Expand lightweight documentation and onboarding to reinforce consistent component usage 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.

Reinforce Internal Adoption

Expand lightweight documentation and onboarding to reinforce consistent component usage 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 Together.

Wu & Why

An independent design practice

© 2026, Lucy Wu. All rights reserved

Let's Make Something Clear Together.

Wu & Why

An independent design practice

© 2026, Lucy Wu. All rights reserved

Let's Make Something Clear Together.

Wu & Why

An independent design practice

© 2026, Lucy Wu. All rights reserved

Let's Make Something Clear Together.

Wu & Why

An independent design practice

© 2026, Lucy Wu. All rights reserved