Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/teambit/base-ui
The basic bit.dev React component design system.
https://github.com/teambit/base-ui
Last synced: about 2 months ago
JSON representation
The basic bit.dev React component design system.
- Host: GitHub
- URL: https://github.com/teambit/base-ui
- Owner: teambit
- License: other
- Archived: true
- Created: 2020-03-25T12:55:58.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2021-05-03T19:58:54.000Z (over 3 years ago)
- Last Synced: 2024-06-18T07:32:55.225Z (3 months ago)
- Language: TypeScript
- Homepage: https://bit.dev/bit/base-ui
- Size: 642 KB
- Stars: 58
- Watchers: 9
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://bit.dev/bit/base-ui)
# Base component design system of Bit.dev
The [reusable set of infra-level React components](https://bit.dev/bit/base-ui)
used to build [Bit.dev](https://bit.dev).
## Components
All components in this frontend codebase were [contained and exposed using Bit](https://github.com/teambit/bit) as a set of independently-usable components. See the **[base collection on bit.dev](https://bit.dev/teambit/base-ui)** to explore and integrate any component into your project.
- Install independent components with npm/yarn.
- Use `bbit import` to source and edit components locally for quick editing and integration.
- Try any component hands-on in a live playground.
## This is a component-based micro-frontend
Wait.. what?
- Install independent components with `bbit install`
- Use `bbit import` to explore components in your local workspace and modify them to your own needs.
- Try any component hands-on in the docs' live playground and in the 'compositions' page.
### Show me an example!
Take a look at the [bit.dev homepage](https://bit.dev/).
You will notice that it's built from components that live in different front-end codebases:
- ["Evangelist" marketing components](https://github.com/teambit/evangelist).
- [base-ui components](https://github.com/teambit/base-ui).
- Container application (private).
- etc
We use [Bit](https://github.com/teambit/bit) to contain and expose components from any codebase as a set of APIs in [bit.dev](https://bit.dev) that can be integrated into different pages and applications. For example:
- Exposed ["Evangelist" marketing components] on bit.dev.
- Exposed [base-ui components on bit.dev](https://bit.dev/teambit/base-ui).
## Structure:
### Theme
All shared styles, colors, sizes, fonts, and css variables, belong here.
[Theme-provider](https://bit.dev/teambit/base-ui/theme/theme-provider) applies all of these styles at the root of your app, and different apps may implement their own unique theme.
### Constants
Hard coded singleton values, like storage-url and enums. In case of change, this central location could update all other components.
### Layout
Components controlling the position of elements in the document. (Grid, breakpoints, etc)
### Atoms
Generic building blocks for any front end application.
These components are 'vanilla', meaning they should not contain content (like texts or icons) and no specific styles. This is because different designs could look entirely different, so any styles in the base component could lead to a 'CSS Specificity War'. So, add the bare minimum of css here and keep these components purely logical!
### Utils
Pure logic components and helpers. (no visual components)
## Setup
1. Install Bit: `npm install @teambit/bit --global`
2. Clone this Bit Workspace: `git clone https://github.com/teambit/evangelist.git evangelist`
3. Go to the workspace directory: `cd evangelist`
4. Install all packages and import all components: `bbit install`
5. Run the Workspace UI to explore the Evangalist components: `bbit start` and go to https://localhost:3000
6. Enjoy!