-
-
Notifications
You must be signed in to change notification settings - Fork 32.4k
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
[docs] Add "Overview" page to Base docs (#32310)
Co-authored-by: danilo leal <[email protected]>
- Loading branch information
1 parent
5d31b54
commit ab60e53
Showing
4 changed files
with
53 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,37 @@ | ||
# MUI Base - Overview | ||
|
||
<p class="description">MUI Base is a library of blank ("unstyled") React UI components and low-level hooks.</p> | ||
|
||
## Introduction | ||
|
||
MUI Base is a library of unstyled React UI components. | ||
It features the same robust engineering as Material UI, but without implementing Material Design. | ||
|
||
It includes prebuilt components with production-ready functionality, along with low-level hooks for transferring that functionality to other components. | ||
|
||
With MUI Base, you can rapidly build on top of our foundational components using any styling solution you choose—no need to override any default style engines or settings. | ||
|
||
> **Note:** _as of Q2 2022, Base is currently still in alpha._ | ||
> | ||
> We're adding new components regularly, and you're welcome to contribute! | ||
> | ||
> Look for the [`package: base` label](https://github.com/mui/material-ui/labels/package%3A%20base) on open [issues](https://github.com/mui/material-ui/issues) and [pull requests](https://github.com/mui/material-ui/pulls) in the `@mui/material-ui` repository on GitHub to see what other community members are working on, and feel free to submit your own. | ||
## Advantages of MUI Base | ||
|
||
- **Ship faster:** MUI Base gives you the foundational building blocks you need to assemble a sleek and sophisticated user interface in a fraction of the time that it would take to do it all from scratch. | ||
|
||
- **You own the CSS:** unlike Material UI, which uses Emotion as a default style engine, MUI Base has no built-in styling solution. | ||
This means you have complete control over your app's CSS. | ||
|
||
- **Accessibility:** MUI Base components are built with accessibility in mind. | ||
We do our best to make all components screen reader-friendly, and offer suggestions for optimizing accessibility throughout our documentation. | ||
|
||
### MUI Base vs. Material UI | ||
|
||
MUI Base features many of the same components as Material UI, but _without the Material Design implementation_. | ||
|
||
Base is not packaged with any default theme or built-in style engine. | ||
This makes it a great choice if you need complete control over how your app's CSS is implemented. | ||
|
||
You could think of MUI Base as the "skeletal" or "headless" version of Material UI—in fact, future versions of Material UI will use Base components and hooks for their foundational structure. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,11 @@ | ||
import * as React from 'react'; | ||
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs'; | ||
import { | ||
demos, | ||
docs, | ||
demoComponents, | ||
} from 'docs/data/base/getting-started/overview/overview.md?@mui/markdown'; | ||
|
||
export default function Page() { | ||
return <MarkdownDocs demos={demos} docs={docs} demoComponents={demoComponents} />; | ||
} |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters