Redesigning components for an existing design system

What to do when a component is no longer aligned and causes downstream usability issues

Michelle Chiu
Feb 5 · 8 min read
Illustration by Manuel Rovira

As a designer, have you ever come across an outdated component in your design system that was no longer serving the needs of your team? Dusty from the years since its conception, it fails to provide its original value as it has accumulated its fair share of pain points and usability issues? If this sounds familiar, redesigning the component may be the best thing you can do for yourself and for your design team moving forward. This is a step-by-step guide on how to do just that based on a recent side project I worked on at MongoDB.

Step #1: Audit the component’s current usage across your product’s platform.

In order to best understand the potential value a newly designed component can provide for future projects, identify where it has been in former projects. Explore your current application or platform to best understand what specific contexts it lives in.

Internal audit board I created to map out documented usage for my team’s stepper component

Step #2: Identify pain points and poor usability attributes.

Write down all of the different pain points you’ve experienced using this component and all of its areas of improvements. Then, transition into internal interviews with members on your design team who have used this component in their former projects. From this internal research, you’ll be able to learn more about the reasoning behind its usage and confirm existing or discover new pain points across a multitude of different teams within your organization.

For my specific stepper component, below are examples of pain points I collected from speaking with my team.

  1. Limited Step Count
    The component’s width size doesn’t allow for a high number of steps due to its limited parent container size.
  2. Inconsistent Sizing
    Currently, the step indicator component faces challenges that come with its usage, specifically with sizing. As check-marks are added and font weights change as users progress through steps, the bar increases in width, making it difficult to work with a fixed parent container.
  3. Accessibility
    The visual language of steps that have not yet been completed may be hard for users with visual impairments to read.
  4. Inability for Customization
    Currently, the standard is to use a check-mark icon for every stage of the process in the stepper component that has been completed. Allowing flexibility into adding different icons for different steps may aid in visual designs.
  5. Unclear Divide
    The margins and spacing between the different steps seem to be on the narrower end. Increasing this may allow for higher contrast and easier distinction between the stages.

Step #3: Outline key functional aspects of the ideal component.

Analyze the data you’ve collected and write down a list of principles that you’d like the new component to embody. Creating a vision for what improvements can be made will help focus on fixing the weaknesses the current component has.

You can find examples of the ideal principles I wrote for my stepper component below:

  1. Contrast Ratio
    Adopt a minimum contrast standards to align with the W3 (AA), a 4.5:1 contrast ratio. Here’s a helpful tool to check contrast for your elements: Also, a helpful resource on contrast guidelines:
  2. Character/Word Limit
    Each step should contain a specific character or word limit in order to ensure less risk of an inconsistent visual balance in wording.
  3. Account for Long Step Counts
    There should be a way for users to navigate the stepper component, even in scenarios when the step count is large.
  4. Be “Clickable”
    To allow users to easily maneuver between previous steps, it should be clear that steps of the stepper component allows this functionality — making it obvious the step itself can be clicked.
  5. Vertical Version (slated for future work)
    When the user has to complete tasks that may have a large step count and the horizontal real-estate may not be as available, it may be helpful to use a vertical version of the stepper.

Step #4: Audit existing components across current design systems.

Below is a list of existing design systems that I explored during this phase of the project along with their respective links. This can serve as a solid foundation if you’re not familiar with most design systems already.

Competitive audit board I curated focused on stepper components

Step #5: Iterate, prototype, and test.

This is my favorite part — exploring a myriad of options derived from the inspiration of your competitive audit in addition to ideas from your own early sketches. Lay them all out on a collaborative prototype screen so that you’re able to share them with other members of the team to gather comments. From the feedback, nail down 4–5 options that seem to be the strongest directions. You’ll be evaluating the alternatives in external user testing.

A snippet of my early first-draft concepts of the stepper component

It may also help to develop early concepts for other states of the component in order to help visualize the designs further.

A snippet of my early first-draft concepts for completed steps of the stepper component

After selecting the specific designs, focus on your goals for the user research studies by defining the UX principles you’d like to test (i.e. discoverability, comprehension, etc.). To save on time, I performed task analysis on remote, unmoderated users on I understand that not all design teams have the budget and resources to use a third-party service; you can also perform internal testing within your company or recruit outside participants to gather this data.

Here are some example questions from my user testing script below to act as a baseline for your own use.

- What are some elements that catch your eye on this page?
- What do you think the user is attempting to accomplish on this screen? How do you know this?
- What do you think you will be doing next? How do you know this?

- What do you think about this element now that you’ve seen it in this page context? What do you think it means?
- Give me a rating on how clear it was on a scale from 1–7 (1 being least clear, 7 being most clear). Why?
- What are some hover interactions you’d expect from this component?
- If you had a magic wand that could change anything about this component, what would you alter (if anything)?

To better organize your test results for analysis, create a table that captures your data in a structured manner. I watched countless videos and jotted down whether or not a participant passed the task I asked of them (indicated with a checkmark). For questions that were more open-ended, I copied the answers into the matrix.

A small portion of user testing results I collected

Step #6: Gather feedback through a “Request for Comments” (RFC).

You’ve done some user testing now, but you should confirm the design decisions you’ve made up to this point with your peers. Your team will be the ones that will be using the component in their projects extensively, and, in turn, users will ultimately be the ones impacted heavily since they’ll be interacting with the component the most. By speaking with colleagues, this gives you additional feedback on the visual and interaction design and also gives others on the design team an opportunity to voice their thoughts on the progress of the project.

*Keep in mind, you do not have to follow all suggestions as long as you can defend your decisions and reasoning.

Step #7: Define guidelines for all possible states.

Make sure your designers are aware of the colors, padding and margin measurements, and interaction behaviors for all the different states of your component. Placing your component in a sample page context also helps envision how it could be used.

Guidelines I created for my new stepper component

Step #8 (Optional): Add animation to amplify the user experience through micro-interactions.

To amplify the design of your component, animation may be a great addition to enhance micro-interaction elements and add polish to the component.

For my specific use case, I’ve linked the prototype I created to show hover animations for my component.

Step #9: Create the Sketch symbol. Ship!

Work with someone from your design systems team to establish the different states that you need to create as a handoff file. Then, hand it off to the team responsible for developing the component that you redesigned. Once the component is fully built, share it with your team and include the guidelines to remind your peers of the appropriate usage behavior. Moving forward, it may help to include the component file in a shared space or add it to your design system library where others can find it quickly.

If your company does not have a dedicated design systems team, this might be a great time for you to brush up on your coding skills to develop the component yourself.

Before and After

It’s always fun to see a side-by-side comparison of old and new designs. Be sure to thank those that’ve helped you with your redesign project and be on the constant lookout for how your design system can be improved!

Old stepper vs. new stepper

If you enjoyed this article, please recommend it or share it with a friend.

Special thanks to Dave McCarthy and Rob Audroué for their help on this project and to Nelle McDade for offering feedback on early drafts of this blog post. We’re currently hiring for our engineering and product design roles. Find out more on our careers page.

If you’d like to reach out, you can find me on my website or on Instagram. Follow my newsletter to keep up-to-date on my newest blog posts and links to provoking stories.

All opinions are my own, views are my own, opinions and any advice given here are my own and do not represent an official statement by my employer, etc.

The Startup

Medium's largest active publication, followed by +607K people. Follow to join our community.

Michelle Chiu

Written by

Product designer at MongoDB. Formerly frog design, Wish, BuzzFeed, DoorDash, Apple, Microsoft. Follow my newsletter:

The Startup

Medium's largest active publication, followed by +607K people. Follow to join our community.

More From Medium

More from The Startup

More from The Startup

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade