TypeScript icon, indicating that this package has built-in type declarations

0.57.1 • Public • Published

Build Status License: MIT npm GitHub stars


A collection of lightweight and easy-to-customise controlled React components

💡 Why?

In the last few year we've had a chance to test a good number of UI libraries, each with its own strengths and weaknesses, but none that matched our expectations in terms of ease of customization.

In fact, our attempt at customizing the style and behavior of the libraries we've tested would generally result in one or more of the following:

  • an inordinate growth in the number of dependencies of our projects, often in the form of language transpilers / compilers causing our build process to grow in complexity beyond reason;
  • a struggle with components carelessly implemented as stateful components where a stateless approach would have resulted in a much better, more performant, more reusable product.

As a result, we've decided to develop a library putting ease of customization as our top priority, focusing on a solid, props-driven API and pure CSS.

🎓 Principles

  • Unopinionated and highly customisable.
  • Driven by grace: instead of customising the padding/margin/color/whatever of a single component, customise the value of padding/margin/color/whatever trough a configuration file, the library will then generate a tailored style keeping grace between components.
  • Render behaviour: the majority of the exported components accept a render prop to possibly customise their behaviour
  • Controlled components: exports controlled components only
  • Lightweights: import nothing but lightweight javascript components.

☕️ Features

  • Concise API
  • Small and lightweight
  • Easy to use
  • Easy to customise
  • Fully written in old-school JS (although TS types are supported)
  • Based on Tailwindcss


Contributions are very welcome and wanted.

To submit your custom pull request, please make sure your read our CONTRIBUTING guidelines.

Before submitting a new pull request, please make sure:

  1. You have updated the package.json version and reported your changes into the CHANGELOG file
  2. make sure you run npm test and npm build before submitting your merge request.
  3. make sure you've added the documentation of your changes.
  4. if you've changed the signature of a component, please make sure you've updated the index.d.ts file.


This library is provided and sponsored by:

As part of our commitment to support and contribute to the open source community.

Icon made by Freepik from




Package Sidebar


npm i beautiful-react-ui

Weekly Downloads






Unpacked Size

1.58 MB

Total Files


Last publish