ProjectsBlogRésuméAbout
Back
Boulevard

BLVD UI Design System

Building BLVD UI — Boulevard's design system for Boulevard Dashboard.

BLVD UI Design System
When
  • 2020 — 2021
Platform
  • Web
Expertise
  • Design Systems Design
  • UX/UI Design
  • Front-End Development
Tools and Tech
  • Figma
  • React
  • Storybook

Background

Boulevard is a business management platform developed to help streamline the operations of appointment-based businesses, including e-commerce for services and goods, point-of-sale, and scheduling appointments.

My Role

I spearheaded the research, prioritization, design, and implementation of BLVD UI design system. Moreover, I established a comprehensive component-driven design and development process from start to finish to align product, product design, and engineering priorities with design system initiatives.

Challenge

  • With no design oversight for years, there needed to be more consistency and coherency in the UI.
  • The current design system is Material UI, with little original code and no original documentation.
  • Updating the visual language while remaining consistent with the current design language based on Material UI.
  • Some Material UI components were adopted into the product, but sometimes the UX did not follow Material UI's design principles and guidelines.
  • Creating a design system that can function seamlessly across both new and legacy code and two JavaScript frameworks (React and Angular).

Research and Planning

UI Inventory

I started documenting each color and common UI element by creating a repository of screenshots. After exploring the app from end to end, I categorized each common UI element to see commonalities better.

Research

I needed to understand the process, design, and technical obstacles and create a plan to simplify them. The problems were mainly related to a need for more processes or knowledge. We needed to address the following issues:

  • Is there full support from product design, engineering, product management, and executives to undertake the challenge of untangling the current design and creating a design system from scratch?
  • How well-versed are the design and engineering team in design systems and systems thinking?
  • At what point will design system input be required in the design and development process?
  • What are the challenges in integrating the design system with the existing design? How will the new designs blend with the current design?

The product design and engineering team was relatively small, I interviewed a few engineers to get an understanding of their pain points so they could be prioritized and addressed in the early stages.

Insights

Team
All relevant stakeholders were committed and eager to establish a design system for our product.
The design and engineering team had a basic understanding of the significance of design systems and their functioning.
Process
As the product design team was relatively new, there needed to be an established process for the design system, component-driven design and development, and end-to-end workflow.
A lack of process would mean a more hands-on approach in most design discussions and decisions while we established a solid foundation for the design system.
Engineers often had to make design decisions independently when the designs lacked clarity.
Design System
We did not have a design system catering to our product but a comprehensive UI kit and component library for a much wider audience.
Material UI was prevalent in Dashboard, which provided a strong foundation for design guidelines and components.
Material UI was not suitable for dense enterprise user interfaces.

Results

Ignite Shared Component Library in Storybook
BLVD UI Figma Library
Foundations

To establish the design system, we first focused on setting up the design tokens. As we were still in the transitional phase and lacked components, we provided engineers with the design tokens that could be used in the application to achieve alignment with the design system. The foundation of the design system consisted of various design tokens, including a color system, typography scale, iconography, shadows, opacities, and more.

Component UI Kit and React Library

Atomic components like buttons, form elements, icons, and text components followed design tokens. The components utilized design tokens for various design decisions.

To ensure everyone was on the same page and referencing the exact source of truth, each component in Figma had variants primarily consistent with the API of its code component counterpart. I used the same terminology for both Figma and React components where appropriate.

The React component library utilized Storybook to showcase each component and its variations. Storybook is a vital tool in the component development process, as it allows engineers and designers to view production-ready components and test them in a sandbox environment. Storybook was also utilized to test interactions and states through controls and perform basic accessibility testing.

Accessibility

Accessibility is a cornerstone of any design system. WCAG 2.1 compliance was a top priority. To achieve this, we utilized the a11y addon in Storybook that automatically tested each component and provided a report in Storybook.

We also tested our color system and ensured pairings met the WCAG 2.1 AA standard of a 4.5:1 contrast ratio. Additionally, we provided captions or alternate text for all media to ensure content accessibility. Every component allowed keyboard control, enabling users to navigate the application solely with a keyboard.

A New Design Component-Driven Process
Ignite Shared Component Library in Storybook
BLVD UI React Component Library in Storybook

As a result of finding a rhythm for the design system build-out and various communication and support channels, we documented a component-driven design and development process that can be repeated.

Included in this process:

  • End-to-end design and development process for the design system and consumption.
  • Definition of roles between the design systems team and product design and engineering.
  • How to contribute and report bugs.
  • Communication touch points such as announcements, changes and updates, and support.
  • Component templates.
  • Documentation templates.
Governance & Support

To ensure the effectiveness of a design system, it must continually evolve and adapt to changing business, design, and technical requirements. However, the team must clearly understand the design system and its proper usage for it to be beneficial.

A design system is a constantly evolving and progressing asset that needs to be understood and utilized by the whole team to provide utility. To support the team working with the design system, I provided:

  • Comprehensive guides for onboarding, setup, usage, and the design system's design and development process.
  • Detailed design and technical documentation for each design token and component.
  • Regular 1:1 design reviews with product designers to ensure their work aligns with the design system and identify potential needs for new components or component updates.
  • Weekly office hours are conducted over Zoom to answer questions, receive feedback, and offer assistance.

Final Thoughts

Although I had previous experience with design systems and UI kits, this was my first role dedicated to design systems. I learned a great deal about processes and management, as a design system requires the participation of everyone and their commitment to succeed and evolve. It takes a village to develop and maintain a design system, and all stakeholders must have a basic understanding and support for the system to thrive.

See my resume

View or download my resume. You can also find me on LinkedIn.

Drop me a line

Please feel free to contact me
if you want to level up your design system, or just to say hello.

me@chrisgriffin.org / Linkedin / Github
©2024, Chris Griffin. Made in California.