Skip to content

Commit

Permalink
[docs] Add "Overview" page to Base docs (#32310)
Browse files Browse the repository at this point in the history
Co-authored-by: danilo leal <[email protected]>
  • Loading branch information
samuelsycamore and danilo-leal authored Apr 28, 2022
1 parent 5d31b54 commit ab60e53
Show file tree
Hide file tree
Showing 4 changed files with 53 additions and 1 deletion.
37 changes: 37 additions & 0 deletions docs/data/base/getting-started/overview/overview.md
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.
5 changes: 4 additions & 1 deletion docs/data/base/pages.ts
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,10 @@ const pages = [
{
pathname: '/base/getting-started',
icon: 'DescriptionIcon',
children: [{ pathname: '/base/getting-started/installation' }],
children: [
{ pathname: '/base/getting-started/overview', title: 'Overview' },
{ pathname: '/base/getting-started/installation', title: 'Installation' },
],
},
{
pathname: '/base/react-',
Expand Down
11 changes: 11 additions & 0 deletions docs/pages/base/getting-started/overview.js
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} />;
}
1 change: 1 addition & 0 deletions docs/translations/translations.json
Original file line number Diff line number Diff line change
Expand Up @@ -182,6 +182,7 @@
"/system/styles/basics": "Basics",
"/system/styles/advanced": "Advanced",
"/base/getting-started": "Getting started",
"/base/getting-started/overview": "Overview",
"/base/getting-started/installation": "Installation",
"/base/react-": "Components",
"inputs": "Inputs",
Expand Down

0 comments on commit ab60e53

Please sign in to comment.