Introducing neetoUI v6

Goutham Subramanyam

By Goutham Subramanyam

on February 22, 2024

Introduction

neetoUI is an open-source React component library developed for neeto. It makes it easier to build accessible and consistent UI in React applications. It is currently being used in more than 20 neeto products. In this blog post, we will explore the exciting new features and enhancements of neetoUI.

The Spark

Though we were using neetoUI across all our products, we had to avoid neetoUI in certain products that followed a different UI style. For example, neetoCode, a coding platform built by BigBinary, has its own special design that is drastically different from the established neetoUI style. So, while building the new landing page for neetoCode, we also had to create custom buttons and form elements that followed the neetoCode design.

Secondly, neetoUI only supported theme overrides. This means the users could easily override the color scheme of neetoUI just by replacing the color variables. But with neetoCode, just updating the theme was not enough. From button sizing to border radius and variants, every component was different in the neetoCode design system. That's when we realized that neetoUI requires even more customization options to improve its adaptability.

The Solution

To enhance the customizability of neetoUI, we planned to implement a set of customization features similar to popular design systems like Bootstrap and Ant design. These features would allow users to adapt the library to their unique design without compromising on the core advantages of using neetoUI. Apart from the color theming which neetoUI already supported, we also wanted to introduce component styling and responsive typography to further advance the customizability of neetoUI.

The Execution

neetoUI has more than 30+ components and enhancing the customizability of those components was not an easy task. We approached each component one by one and refactored the respective styles to use CSS variables for all the properties.

Let’s take the example of the Button component from neetoUI. Earlier we could only customize the colors used in the buttons. But with v6, we have made every aspect of the button like padding, border-radius, font size, etc. to be customizable.

Here is the list of variables used by the Button component.

CSS

1--neeto-ui-btn-padding-x: 8px;
2--neeto-ui-btn-padding-y: 6px;
3--neeto-ui-btn-font-size: var(--neeto-ui-text-sm);
4--neeto-ui-btn-font-weight: var(--neeto-ui-font-medium);
5--neeto-ui-btn-line-height: 16px;
6--neeto-ui-btn-color: rgb(var(--neeto-ui-black));
7--neeto-ui-btn-bg-color: transparent;
8--neeto-ui-btn-border-width: 0;
9--neeto-ui-btn-border-color: transparent;
10--neeto-ui-btn-border-radius: var(--neeto-ui-rounded);
11--neeto-ui-btn-gap: 4px;
12--neeto-ui-btn-icon-size: 16px;
13--neeto-ui-btn-box-shadow: none;
14--neeto-ui-btn-outline: none;
15
16// Disabled
17--neeto-ui-btn-disabled-opacity: 0.5;
18
19// Hover
20--neeto-ui-btn-hover-color: rgb(var(--neeto-ui-black));
21--neeto-ui-btn-hover-bg-color: transparent;
22--neeto-ui-btn-hover-box-shadow: none;
23--neeto-ui-btn-hover-opacity: 1;
24
25// Focus
26--neeto-ui-btn-focus-color: rgb(var(--neeto-ui-black));
27--neeto-ui-btn-focus-box-shadow: none;
28--neeto-ui-btn-focus-opacity: 1;
29
30// Focus Visible
31--neeto-ui-btn-focus-visible-color: rgb(var(--neeto-ui-black));
32--neeto-ui-btn-focus-visible-outline: 3px solid rgba(var(--neeto-ui-primary-500), 50%);
33--neeto-ui-btn-focus-visible-outline-offset: 1px;
34--neeto-ui-btn-focus-visible-box-shadow: none;

The users can now tweak each property of the Button component using these variables and create their version of the component. You can see it in action, here.

Button customization examples

Edit in CodeSandbox

Likewise, we have updated all the components and the new neetoUI storybook has examples on how to override each component.

The Result

With all the customization improvements, neetoUI v6 has been released to the public. Just by changing a few CSS variables, you can now change the look and feel of neetoUI at both the global and component levels to match your exact design requirements.

Button customization examples

Do visit this page to understand the nuances of neetoUI v6 up close.

We hope you have a clearer understanding of the improvements we have made to the library. Do try it out and let us know your feedback.

Stay up to date with our blogs. Sign up for our newsletter.

We write about Ruby on Rails, ReactJS, React Native, remote work,open source, engineering & design.