@auth0/styleguide-react-components1.0.4 • Public • Published
Auth0 Styleguide - React Components
Library of Auth0 React components. All the react-bootstrap components are re-exported inside this lib.
You can find the API, see examples, and play with live editing of every component on the React Components section of our styleguide.
If you are using npm you can do (react and react-bootstrap are peer dependencies):
npm i --save react@15 email@example.com @auth0/styleguide-react-components
And load the CSS from our CDN:
<!-- Core and Components CSS bundles are peer dependencies of react-components -->
The CSS bundles are also included on the packages installed via npm, but we encourage you to use it via our CDN so we all benefit from sharing the same url of the package to improve load time.
Here is a quick example to get you started:
;;;const App =<div><Button>+1</Button></div>;ReactDOM;
Add a new component
Node.js v6.9.1 and npm v3.10.8 or newer is required.
You can develop new components using React StoryBook.
examples.js files will be used to generate the React Styleguide page of the component, which will contain all the documentation for it (title, description, examples and table with properties information).
To create a new component run
npm start and add your component inside the
/src folder with the following files:
Main component file, it should export the component.
We use react-docgen to extract information from this file to generate the documentation of our components. You should use the following structure:
;;/*** Example component title: Example component description.*/const ExampleComponent =<div>Example component</div>;ExampleComponentpropTypes =/*** prop1 description*/prop1: PropTypesarrayisRequired/*** prop2 description*/prop2: PropTypesnumberisRequired;;
This file will generate the following page in the React Styleguide website:
The comment on top of the component definition will match with the page title and description, while the comments on top of the propTypes definitions will match with the definitions of the properties table.
Export an array of objects representing the different examples of the component to showcase them in the Auth0 React Styleguide.
Each object of the array can have the following properties:
|component||React element||React element|
|code||string||Code of the component (should match the code of the component property)|
|center||boolean||Center the component in the middle of the playground|
|showTitle||boolean||Show the example title|
|url||string||Url for the component page|
;;const examples =component:<ExampleComponent />code: `<ExampleComponent />`title: 'Example title'center: trueshowTitle: trueurl: 'default';;
Add stories for your React component. You can check React StoryBook - Writing Stories for more information.
Follow this conventions when you are developing components:
- Your components should be stateless functional components (they shouldn't contain state or lifecycle methods so we can use them with state management libraries like Redux).
- Add propTypes for all properties and add the proper comments so that information is shown in the Auth0 React Styleguide.
- Prefix your component css classes with its name so it doesn't conflict with others existing classes.
Releasing a new version
Run the command
bin/version <patch|minor|major|version-no> inside the root of this package. This will commit a new version for you.
All the logos and branding are copyright Auth0 and may not be used or reproduced without explicit permission from Auth0 Inc.
The icons are licensed from Budi Harto Tanrim. All other third-party components are subject to their own licenses.