Base Web React Components (fork)

Base is a design system comprised of modern, responsive, living components originally created by Uber. Base Web is the React & TypeScript implementation of Base.

Why fork?

On December 19, 2023 Uber has announced that they would no longer maintain Baseweb. It's not hard to imagine the reasons why given the tech climate in 2023.

On the same day, an aptly named PR "Big codebase and CI cleanup" (#5323) deleted most of the test files, all of the visual regression snapshots, and all of the infrastructure and setup files, effectively kneecapping the repo.

In 2024 they dropped a number of new features and released two "major" versions under the new "Open Source Engagement". To make things worse, they deleted documentation for all previous releases.

This fork begins from the last known stable release, which was v13.0.0. The following work has been performed:

• Unit tests are fully passing. Oddly enough even in v13 tests were not passing.
• Complete overhaul of the visual regression tests infrastructure. Besides many issues that prevented it from running, another aptly named PR "fix tsc" (#5290) deleted two VRT stories. The missing stories prevented VRT from passing. Curiously, this was done on June 9, 2023.
• All dependencies upgraded to latest (as of November 2024), including migration to ESLint 9 with flat config.
• Fixed documentation site build, which also wasn't working.
• Cleaned up and migrated build scripts to wireit.

I've put in almost a month of full-time work to get this repo to a stable point because we have almost 4,000 imports from baseui in our project, and migrating away isn't a viable option.

What's next?

• We will not be implementing any new features ourselves.
• We will review and merge PRs with test coverage however.
• We will upgrading all dependencies at least twice a year and make sure everything works when React 19 ships.
• Publish the docs.
• Finalize release process.

Usage

If you really need to use this right now, you have to add specific SHA to your package.json (details) from this repository until we figure out the release process. Then add peer dependencies:

# using yarn
yarn add styletron-react styletron-engine-monolithic

# using npm
npm install styletron-react styletron-engine-monolithic

import { Client as Styletron } from 'styletron-engine-monolithic';
import { Provider as StyletronProvider } from 'styletron-react';
import { LightTheme, BaseProvider, styled } from 'baseui';
import { StatefulInput } from 'baseui/input';

const engine = new Styletron();

const Centered = styled('div', {
  display: 'flex',
  justifyContent: 'center',
  alignItems: 'center',
  height: '100%',
});

export default function Hello () {
  return (
    <StyletronProvider value={engine}>
      <BaseProvider theme={LightTheme}>
        <Centered>
          <StatefulInput />
        </Centered>
      </BaseProvider>
    </StyletronProvider>
  );
}

Docs

To read the documentation, please visit baseweb.design (coming soon).

Contributing

Contributing