Skip to content

Commit

Permalink
[core] Update all readme files
Browse files Browse the repository at this point in the history
  • Loading branch information
rtivital committed Apr 30, 2021
1 parent dd0a3c5 commit 221bc5d
Show file tree
Hide file tree
Showing 7 changed files with 61 additions and 56 deletions.
53 changes: 22 additions & 31 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,40 +1,31 @@
![Github banner](./github-banner.svg)
# Mantine

Mantine is a customizable component library with focus on accessibility and developer experience.
Mantine is a MIT licensed open source react components and hooks library with focus on usability, accessibility and developer experience.

## Links

- [Getting Started](https://mantine.dev/)
- [Documentation](https://mantine.dev/)
- [Examples](https://mantine.dev/pages/examples/)
- [Components by category](https://mantine.dev/core/getting-started/#components-by-category)
- [Hooks list](https://mantine.dev/hooks/getting-started/#included-hooks)
- [Notifications system](https://mantine.dev/others/notifications/)
- [Contributing](https://mantine.dev/pages/contribute/)

## Installation

To start using Mantine you need to install [`@mantine/core`](https://www.npmjs.com/package/@mantine/core) and its peer dependencies:

```sh
# With yarn
yarn add react-jss @mantine/theme @mantine/hooks @mantine/core

# With npm
npm install react-jss @mantine/theme @mantine/hooks @mantine/core

# With peerdeps
npx install-peerdeps @mantine/core
```

## Usage

Now you can import and use any component from @mantine/core:

```tsx
import { Button } from '@mantine/core';

function App() {
return <Button>Mantine button</Button>;
}
```
- [Ask question or give feedback](https://github.com/mantinedev/mantine/discussions)
- [Sign up for monthly newsletter](https://buttondown.email/mantine)
- [Follow Mantine on Twitter](https://twitter.com/mantinedev)

## Features

- **Customization** – colors, fonts, shadows and many other parts are customizable to fit your design needs
- **Dark theme** – mantine supports dark theme by default in all components
- **Accessibility and usability** – all components follow accessibility best practices and feature full keyboard support
- **TypeScript** – all @mantine/ scoped packages are built with TypeScript and support it by default
- **Ready for production** – mantine is well tested and works in all modern browsers
- **Developer experience** – mantine comes with more than 50 components and 15 hooks to cover you in most cases
- **No annoying focus ring** – with new :focus-visible pseudo-class focus ring appears only when user navigates with keyboard
- **React JSS** – take advantage of all react-jss features: automatic critical css extraction during ssr, lazy evaluation, dynamic theming and others
- **React and Preact** – mantine works flawlessly with preact

## Licence

All @mantine/ scoped packages, dependencies and peer dependencies have MIT licence.
All Mantine packages have MIT licence. All Mantine dependencies also have MIT licence, except react-transition-group package which has BSD-3-Clause license.
1 change: 0 additions & 1 deletion github-banner.svg

This file was deleted.

31 changes: 22 additions & 9 deletions src/mantine-core/README.md
Original file line number Diff line number Diff line change
@@ -1,20 +1,33 @@
# Mantine

![Github banner](https://github.com/mantinedev/mantine/raw/master/github-banner.svg)

Build better React applications. Mantine is a customizable component library with focus on accessibility and developer experience.
Mantine is a MIT licensed open source react components and hooks library with focus on usability, accessibility and developer experience.

## Links

- [Documentation](https://mantine.dev/)
- [Getting Started](https://mantine.dev/getting-started/)
- [Examples](https://mantine.dev/examples/)
- [Contributing](https://mantine.dev/source/)
- [Examples](https://mantine.dev/pages/examples/)
- [Components by category](https://mantine.dev/core/getting-started/#components-by-category)
- [Hooks list](https://mantine.dev/hooks/getting-started/#included-hooks)
- [Notifications system](https://mantine.dev/others/notifications/)
- [Contributing](https://mantine.dev/pages/contribute/)
- [Ask question or give feedback](https://github.com/mantinedev/mantine/discussions)
- [Sign up for monthly newsletter](https://buttondown.email/mantine)
- [Follow Mantine on Twitter](https://twitter.com/mantinedev)

## Features

- **Customization** – colors, fonts, shadows and many other parts are customizable to fit your design needs
- **Dark theme** – mantine supports dark theme by default in all components
- **Accessibility and usability** – all components follow accessibility best practices and feature full keyboard support
- **TypeScript** – all @mantine/ scoped packages are built with TypeScript and support it by default
- **Ready for production** – mantine is well tested and works in all modern browsers
- **Developer experience** – mantine comes with more than 50 components and 15 hooks to cover you in most cases
- **No annoying focus ring** – with new :focus-visible pseudo-class focus ring appears only when user navigates with keyboard
- **React JSS** – take advantage of all react-jss features: automatic critical css extraction during ssr, lazy evaluation, dynamic theming and others
- **React and Preact** – mantine works flawlessly with preact

## Installation

To start using Mantine you need to install [`@mantine/core`](https://www.npmjs.com/package/@mantine/core) and its peer dependencies:

```sh
# With yarn
yarn add @mantine/core @mantine/hooks react-jss
Expand All @@ -40,4 +53,4 @@ function App() {

## Licence

All @mantine/ scoped packages, dependencies and peer dependencies have MIT licence.
All Mantine packages have MIT licence. All Mantine dependencies also have MIT licence, except react-transition-group package which has BSD-3-Clause license.
3 changes: 3 additions & 0 deletions src/mantine-dates/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Mantine dates

This package is WIP
5 changes: 2 additions & 3 deletions src/mantine-hooks/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,6 @@
# Mantine Hooks

React hooks for [Mantine](https://mantine.dev/) components library. All other @mantine/ packages depend on @mantine/hooks.

React hooks for [Mantine](https://mantine.dev/) components library.
Package includes hooks that are used to build components in @mantine/ scoped packages.
You can use these hooks in your applications with or without other @mantine/ packages.

Expand Down Expand Up @@ -38,4 +37,4 @@ npm install @mantine/hooks

## Licence

All @mantine/ scoped packages, dependencies and peer dependencies have MIT licence.
All Mantine packages have MIT licence. All Mantine dependencies also have MIT licence, except react-transition-group package which has BSD-3-Clause license.
14 changes: 7 additions & 7 deletions src/mantine-notifications/README.md
Original file line number Diff line number Diff line change
@@ -1,24 +1,24 @@
# Mantine Notifications

![Demo](./demo.gif)

Notifications system built on top of [Mantine](https://mantine.dev/) components library.

[Documentation](https://mantine.dev/others/notifications/)

## Installation

```sh
# With yarn
yarn add @mantine/notifications @mantine/core @mantine/theme @mantine/hooks react-jss
yarn add @mantine/notifications @mantine/core @mantine/hooks react-jss

# With npm
yarn add @mantine/notifications @mantine/core @mantine/theme @mantine/hooks react-jss
yarn add @mantine/notifications @mantine/core @mantine/hooks react-jss

# With install-peerdeps
npx install-peerdeps @mantine/notifications
```

## [Documentation and demos](https://mantine.dev/notifications/getting-started/)

![Demo](./demo.gif)

## Licence

All @mantine/ scoped packages, dependencies and peer dependencies have MIT licence.
All Mantine packages have MIT licence. All Mantine dependencies also have MIT licence, except react-transition-group package which has BSD-3-Clause license.
10 changes: 5 additions & 5 deletions src/mantine-tag-picker/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,11 @@
# Mantine Tag Picker

![Demo](./demo.gif)

Notion like tag picker component built on top of [Mantine](https://mantine.dev/) components library.

[Documentation](https://mantine.dev/others/tag-picker/)

## Installation

```sh
Expand All @@ -15,10 +19,6 @@ yarn add @mantine/tag-picker @mantine/core @mantine/hooks react-jss
npx install-peerdeps @mantine/tag-picker
```

## [Documentation and demos](https://mantine.dev/tag-picker/getting-started/)

![Demo](./demo.gif)

## Licence

All @mantine/ scoped packages, dependencies and peer dependencies have MIT licence.
All Mantine packages have MIT licence. All Mantine dependencies also have MIT licence, except react-transition-group package which has BSD-3-Clause license.

0 comments on commit 221bc5d

Please sign in to comment.