Uber Base Design System

Base Web is the React library behind Uber's Base design system. The npm package is baseui; the current release line is 18.x, with React 18 or newer and styletron-react 6 or newer as peer dependencies. The npm downloads API reported about 270,000 downloads for the 30 days to October 18, 2026 (api.npmjs.org, checked October 2026): a working library with real production use behind it, not a showcase project.

How it is put together Two decisions define Base Web. The first is Styletron. Instead of shipping a stylesheet per component, Styletron composes atomic CSS classes at runtime, so adding a component does not add a parallel block of CSS. Style growth stays close to the components you actually render.

The second is the overrides API. Almost every element inside a component can be restyled through a single overrides prop, down to nested subcomponents. Teams typically use it to adapt spacing, borders, and type to their own tokens while keeping Uber's interaction logic: focus management, keyboard handling, and layering.

Layers, done properly Most UI libraries leave modal, popover, and toast stacking to z-index folklore. Base Web includes a Layer component and a layers manager that mounts floating elements in a managed stack near the root of the tree. Menus open inside dialogs, tooltips escape clipped containers, and nested overlays order themselves consistently. If your product has dense screens with many overlapping elements, this is the strongest reason to consider Base.

Theming and tokens Base ships light and dark themes built from a typed token structure covering colors, typography, sizing, borders, breakpoints, and animation. A createTheme helper merges your primitives over the defaults, so a brand theme is a data change rather than a component rewrite. Because the theme is plain objects, the same tokens can feed documentation and design tooling.

Accessibility The documentation treats accessibility as a first-class concern, and the components reflect that: visible focus states, labelled form controls, keyboard-operable menus and selects, and ARIA attributes wired into the interactive primitives. As with any library, your own content and color choices still decide the final result, so test with your real theme applied.

What you give up Base Web has one visual language, and it looks like Uber: neutral, dense, black and white by default. Making it feel like a consumer brand takes real theming work. It is React only, so Vue or Angular teams get nothing here. The community is smaller than Material UI's or Ant Design's, which means fewer ready-made examples when you hit an edge case. And there is no support channel beyond the GitHub repository and the documentation.

Bottom line Choose Base Web when your team ships a data-heavy React product and wants a maintained component foundation with unusually strong customization and layering. Pick something else if you need a distinctive consumer look out of the box, or if your stack is not React.