Skip to content

Commit

Permalink
Merge pull request #938 from etn-ccis/chore/wordsmith-readme
Browse files Browse the repository at this point in the history
chore: wordsmith readme
  • Loading branch information
joebochill authored Dec 11, 2024
2 parents 78d4f26 + bf22352 commit d2a6b62
Show file tree
Hide file tree
Showing 3 changed files with 25 additions and 52 deletions.
62 changes: 21 additions & 41 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,27 @@ To install the Brightlayer UI react components from NPM as a dependency for your
yarn add @brightlayer-ui/react-components
```

> **NOTE**: This install command will install the package from NPM. If you are a Brightlayer UI developer working with components locally, you will want to follow the manual linking instructions - see below.
## Usage

See the [developer documentation](https://brightlayer-ui-components.github.io/react) site for detailed information on using these components.

> For use with MUI 6+, you must be using version 7 of @brightlayer-ui/react-components and version 8 of @brightlayer-ui/react-themes.
## Migration from v6 to v7

With the release of version 7, Brightlayer UI React Components have been updated to use Material UI v6. The usage of the BLUI components remains the same, but there may be some updates required in your project to migrate to MUI v6.

You can refer to the official [MUI Migration Documentation](https://mui.com/material-ui/migration/upgrade-to-v6/) for details on the steps to upgrade. This will include:

- updating dependency versions
- updating any custom themes (BLUI themes have already been updated for you)
- component API changes / deprecations

## Browser Support

Brightlayer UI libraries will work with any modern browser. For details, please refer to our [Browser Support](https://brightlayer-ui.github.io/development/frameworks-web/react#browser-support) documentation.

# For Maintainers

## Building the Library

Expand All @@ -33,10 +53,6 @@ The library can be built by running the following command. The resulting output
yarn build
```

## Using with @brightlayer-ui/react-themes

We recommend using this library in conjunction with [@brightlayer-ui/react-themes](https://www.npmjs.com/package/@brightlayer-ui/react-themes). If you are using version 6.0.0+ of the Brightlayer UI themes, you must upgrade to at least version 5.1.0 of @brightlayer-ui/react-components, or you may see some unintended default styles on some components.

## Running the demo project and React Component Library API Docs

This repository comes with a demo project found within the `/demos` folder.
Expand All @@ -61,39 +77,3 @@ yarn start:docs
```

from the root directory.

## Using the Components

See the [documentation](https://brightlayer-ui-components.github.io/react) for information on using these components.

## Migration from v6 to v7

With the release of version 7, Brightlayer UI React Components have been updated to use Material UI v6. This migration guide will help you update your project from v6 to v7.

### Steps to Migrate

1. **Update Dependencies**: Update your `package.json` to use the latest version of `@brightlayer-ui/react-components` and `@mui/material`.

```shell
yarn add @brightlayer-ui/react-components@latest @mui/material@latest
```

2. **Theme Updates**: If you are using custom themes, update your theme configuration to be compatible with Material UI v6.

```javascript
import { createTheme } from '@mui/material/styles';
const theme = createTheme({
// your theme configuration
});
```
3. **Component Changes**: Review the [Material UI v6 migration guide](https://mui.com/guides/migration-v4/) for any breaking changes that may affect your components.
4. **Testing**: Thoroughly test your application to ensure all components are working as expected with the new version.
By following these steps, you should be able to successfully migrate your project from v6 to v7 using Material UI v6.
## Browser Support
Brightlayer UI libraries will work with any modern browser. For details, please refer to our [Browser Support](https://brightlayer-ui.github.io/development/frameworks-web/react#browser-support) documentation.
8 changes: 1 addition & 7 deletions components/LICENSES.json
Original file line number Diff line number Diff line change
@@ -1,11 +1,5 @@
{
"@brightlayer-ui/[email protected]": {
"licenses": "BSD-3-Clause",
"repository": "https://github.com/brightlayer-ui/colors",
"licenseUrl": "https://github.com/brightlayer-ui/colors/raw/master/LICENSE",
"parents": "@brightlayer-ui/react-components"
},
"@emotion/[email protected]": {
"@emotion/[email protected]": {
"licenses": "MIT",
"repository": "https://github.com/emotion-js/emotion/tree/main/packages/css",
"licenseUrl": "https://github.com/emotion-js/emotion/tree/main/packages/css/raw/master/LICENSE",
Expand Down
7 changes: 3 additions & 4 deletions components/package.json
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,6 @@
},
"prettier": "@brightlayer-ui/prettier-config",
"dependencies": {
"@brightlayer-ui/colors": "^3.1.1",
"@emotion/css": "^11.10.5",
"@seznam/compose-react-refs": "^1.0.6",
"color": "^4.2.3"
Expand Down Expand Up @@ -49,13 +48,13 @@
"typescript": "^4.8.4"
},
"peerDependencies": {
"@brightlayer-ui/colors": "^3.0.0",
"@brightlayer-ui/colors": "^3.1.0",
"@emotion/react": "^11.7.1",
"@emotion/styled": "^11.6.0",
"@mui/icons-material": "^6.1.8",
"@mui/material": "^6.1.8",
"react": "^16.0.0 || ^17.0.0 || ^18.0.0",
"react-dom": "^16.0.0 || ^17.0.0 || ^18.0.0"
"react": "^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0",
"react-dom": "^16.0.0 || ^17.0.0 || ^18.0.0 || ^19.0.0"
},
"repository": {
"type": "git",
Expand Down

0 comments on commit d2a6b62

Please sign in to comment.