Scaling Visa’s design system for a public audience

Design systems · Content architecture · Governance

Visa Product Design System homepage
The public homepage connects design and development resources through shared entry points.

Overview

The Visa Product Design System brought guidance, design assets, and implementation resources into a public platform spanning React, Angular, CSS, and Flutter. As one of two primary content designers during much of its expansion and public-launch effort, I helped develop reusable content models, align terminology, shape navigation, and prepare guidance for audiences beyond Visa.

At a glance

Growth in Figma web-component instances, 2023–2025
14×
Components
42+
Patterns
13
Development frameworks
4
My role
Content Designer
Timeline
Summer 2021 internshipJune 2023–March 2025

Primary collaborators

Product design
  • Alicia Frausto
  • Tracy Nguyen
  • Murphy Basore
  • Kristin Bonnett
Content design
  • Brandee Dudenhoefer
  • Chine Okeke

Other disciplines

Design Engineering, Accessibility, Legal, Brand, and Design Research

01

Bringing scattered guidance into one system

Guidance, design assets, and implementation resources had developed across documents, Figma files, internal sites, and code libraries. As VPDS expanded, users needed clearer paths between those resources with simplified access points. After rounds of user research, competitive analysis, and in-depth information architecture planning, I worked with cross-functional partners to address key pain points and help turn distributed material into a navigable system.

From one long document to dedicated pages

The Figma guide collected the guidance in one place. The website gave each topic its own page and a clear entry point.

Before · FigmaThe Content Style Guide as one Figma documentation page
The original Figma content style guide, arranged as one long document
0%

Topics followed one another in a single document, requiring users to scan or scroll to find the guidance they needed.

View original ↗
After · WebsiteDedicated Content sections on the public VPDS site
VPDS content overview with dedicated pages for accessible text, grammar and punctuation, inclusive language, information architecture, messaging, placeholder text, readability, and voice and tone

Topic pages and an expanded sidebar provide direct routes to specific guidance.

View original ↗

02

A repeatable structure for 42+ components

Turning distributed resources into a simplified experience was a multi-phase project. As we worked to consolidate, simplify, and standardize our resources, the system was still actively expanding.

Before adding new components to the system, we needed our guidance structure to be scalable. After investigating the most useful information for our users, I helped develop a shared content model that brought usage, behavior, content, accessibility, and development guidance into a predictable hierarchy.

Each page tested the structure: could it accommodate the detail this component needed while keeping guidance consistent across the library?

Shared component-guideline template

Component template introduction, alternate names, contents hierarchy, and Anatomy section
Definitions, anatomy, usage, and detailed guidance follow a repeatable page hierarchy. View original ↗: Component template introduction, alternate names, contents hierarchy, and Anatomy section
  1. Definition and alternate names.
  2. Predictable anatomy and usage sections.
  3. A consistent hierarchy for detailed guidance.

The model applied to Dialog guidance

Dialog usage guidance with definition, alternate names, contents navigation, and complete annotated anatomy with descriptions of title, message, close button, buttons, and overlay
The definition, alternate names, and labeled anatomy show how the shared model accommodates component-specific detail. View original ↗: Dialog usage guidance with definition, alternate names, contents navigation, and complete annotated anatomy with descriptions of title, message, close button, buttons, and overlay

03

Resolving differences between design and code

Applying our new content model across 42+ components meant deeply investigating the contents of our system. Ensuring accurate guidance for each element meant examining how it worked across development frameworks. Simple naming differences frequently revealed inconsistencies in component variants, examples, or coded behavior.

Content design quickly became the connective infrastructure between disciplines. By investigating inconsistencies to ensure written guidance was accurate, we drove a significant standardization effort across development libraries, resulting in a more usable, scalable system.

Current and expected naming for the Button component

One audit image comparing current flat button headings with expected grouped button types and variants; empty space between columns removed
Current example naming compared with expected names, standardized across development libraries. View original ↗: One audit image comparing current flat button headings with expected grouped button types and variants; empty space between columns removed

Annotated comparisons across coded examples

Button examples, proposed variants, and associated review annotations
Annotations connecting current coded examples with differences in variants, icons, behavior, and states. View original ↗: Button examples, proposed variants, and associated review annotations

Component reviews, decision logs, consistency checks, and QA helped carry shared decisions into guidance as the system expanded. My work connected the broader content structure to detailed reviews with design, engineering, and accessibility partners.

04

Clarifying navigation and restoring Patterns

With clearer guidance in place and Figma pages translated into an MVP website, additional research helped us examine whether our proposed navigation matched what people expected to find. Based on additional user research, I helped revisit the distinction between Components, Patterns, and Flows and advocated for reintroducing Patterns with a clearer definition.

Patterns described how components worked together to solve recurring interaction problems. Clarifying that role helped organize guidance around what users needed to do.

05

Preparing the system for a public audience

For the public launch, guidance needed to support people without Visa’s internal context. I contributed to onboarding pathways and Getting Started guidance across React, Angular, CSS, and Flutter, working with engineering partners to balance a consistent structure with each framework’s implementation requirements.

  1. 01 · Choose a starting point

    Design and Develop entry points, each with a Get started button, cropped from the VPDS homepage
    The Develop entry point leads to guidance for getting started with the system, shown next. View original ↗: Design and Develop entry points, each with a Get started button, cropped from the VPDS homepage
  2. 02 · Select a framework

    Start developing with VPDS overview with system orientation and links to CSS, React, Angular, and Flutter setup guides
    The overview introduces the system and links to a Getting Started guide for each development framework. View original ↗: Start developing with VPDS overview with system orientation and links to CSS, React, Angular, and Flutter setup guides
  3. 03 · Follow setup guidance

    Start building with Angular guidance showing framework requirements, package managers, and installation commands
    Choosing Angular leads to its version requirements, package-manager options, and installation steps. View original ↗: Start building with Angular guidance showing framework requirements, package managers, and installation commands

My launch work also included content auditing, SEO and landscape analysis, QA, release communications, and coordination with legal, brand, and accessibility partners.

06

From internal MVP to public platform

  1. Design MVP · 2023Dispersed resources were organized into an internal-only MVP site.
  2. Reusable content structuresClearer connections between guidance and implementation, with shared structures for maintaining and expanding the system.
  3. Public launch · March 2025Guidance, design assets, and implementation resources brought together at design.visa.com ↗.

Helping VPDS grow taught me to investigate the product beneath the language. A naming inconsistency could reveal a difference in behavior; a documentation problem could reveal a gap in the system’s structure. Connecting those details across content, design, and engineering became central to how I approach complex products.