CV & Skills

Get In Touch

Prefer using email? Say hi at

Design quality assurance and the developer experience

Building an Enterprise UI Component Library in Storybook.js

Upon joining my current organisation I was aware that I would be given a degree of autonomy to build a design process as I saw fit for the company. I also knew I would be working on a large digital transformation under a certain number of constraints and a bit of ambiguity. No a problem there, as always, I’m happy to embrace this as a challenge.

As I was embarking on a journey to transform a multitude of products (new and old) I knew I needed to develop a way to effectively manage UX and UI of everything across the whole suite. It was essential to avoid the rabbit hole that is rework and for the sanity of our development team.

Key Considerations

It was apparent that the organisation could benefit greatly from having style guides, patterns and a component library in place but I wanted to validate if there was real value in it. This is what I discovered:

  • There was no current design system but a plan to create one.
  • We knew that as an organisation we could benefit from developing a reusable UI component set or ecosystem.
  • The organisation were going through a period of growth and needed to be able to design with a common language and consistent aesthetic.
  • There was a plan to essentially white-label specific product sets.
  • Current styles were inconsistent. For example, differing button styles.
  • There was a lot of repetition across the whole product team.

So, definitively, I think we were able to say that, a design system would be a great asset to the organisation.

Key Pain Points

We could now pinpoint the high level problems that existed.

  • Design inconsistency. As mentioned above, this was clearly apparent and needed to be nipped in the bud.
  • No clarity on how to implement designs. Developers were building the same design components over and over but with tiny differences each time.
  • There was a demand to release changes and new features quickly.


Obviously, a solution was needed. A design framework, a simple set of design rules that could be easily interpreted and implemented. There was a need to be able to constantly evolve our designs and keep them well maintained. Enter Storybook js.

We reviewed a number of options and even considered building something custom. Fortunately, there are plenty of great options off the shelf and some more suited than others.

Storybook js is one of the most recognised. It is an open source tool for developing UI components in isolation for React, Vue, Angular, and more. It helps to build UIs in an organised and efficient fashion. I knew it was important to consider the developer experience too so being able to design and develop UI components in isolation was a big plus. Similarly for designers, it is also a fantastic experience. It provided the long awaited framework and guidelines the product team needed to work with and could be kept updated and therefore current.

Atomic Design

I wanted the development team to feature heavily in the process. After all, one of the main goals was to make their lives signifcantly easier. I leaned on them for much of the journey and extracted as much information out of them as I could.

In terms of design, I have always instinctively taken a modular approach to designing, delibrately creating components that are reusable across a suite of products. A few years ago I stumbled across Brad Frost’s Atomic design methodology. As it turns out, it is rather similar to what I had already been practicing. So it made perfect sense to continue in the same vein.

Atomic Design by Brad Frost

Image taken from Brad Frost's Atomic Design

Following the Atomic model, I began to create the basic HTML elements to serve as our base styles. The buttons, form inputs etc. With Storybook I was able to lay the foundations and immediately start building the components for these elements.

To be continued…

My apologies, I’ll hopefully have this one finished for you soon.