Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/amaury1093/react-redux-auth0-kit
Minimal starter boilerplate project with CRA, React, Redux, React Router and Auth0 authentication
https://github.com/amaury1093/react-redux-auth0-kit
auth0 authservice babel boilerplate create-react-app es6 eslint live-reload minimal react react-router redux test webpack
Last synced: 2 days ago
JSON representation
Minimal starter boilerplate project with CRA, React, Redux, React Router and Auth0 authentication
- Host: GitHub
- URL: https://github.com/amaury1093/react-redux-auth0-kit
- Owner: amaury1093
- License: mit
- Archived: true
- Created: 2016-10-29T11:56:31.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2021-04-05T22:40:57.000Z (over 3 years ago)
- Last Synced: 2024-09-26T17:05:09.315Z (7 days ago)
- Topics: auth0, authservice, babel, boilerplate, create-react-app, es6, eslint, live-reload, minimal, react, react-router, redux, test, webpack
- Language: JavaScript
- Homepage:
- Size: 733 KB
- Stars: 113
- Watchers: 7
- Forks: 30
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# React Redux Auth0 Kit
Minimal starter boilerplate project with React, Redux, React Router and Auth0 authentication
## Live demo
A live demo of this project with a simple Facebook login via Auth0 is available here: https://react-redux-auth0.firebaseapp.com.
## Getting started
First [create an auth0 account](https://manage.auth0.com/). Then run the following commands. Make sure your `src/utils/config.js` file has the correct values from your auth0 account.
```bash
# Install dependencies
npm install
# Copy configuration and replace with your own
cp src/utils/config.example.js src/utils/config.js
# Run
npm start
```
Open `http://localhost:3000` to see the app running.
## Features
### Auth0
Auth0 helps you to:
* Add authentication with [multiple authentication sources](https://docs.auth0.com/identityproviders), either social like **Google, Facebook, Microsoft Account, LinkedIn, GitHub, Twitter, Box, Salesforce, among others**, or enterprise identity systems like **Windows Azure AD, Google Apps, Active Directory, ADFS or any SAML Identity Provider**.
* Add authentication through more traditional **[username/password databases](https://docs.auth0.com/mysql-connection-tutorial)**.
* Add support for **[linking different user accounts](https://docs.auth0.com/link-accounts)** with the same user.
* Support for generating signed [Json Web Tokens](https://docs.auth0.com/jwt) to call your APIs and **flow the user identity** securely.
* Analytics of how, when and where users are logging in.
* Pull data from other sources and add it to the user profile, through [JavaScript rules](https://docs.auth0.com/rules).
### AuthService
The library `auth0-lock` provides the user authentication, and I also have a `src/utils/AuthService.js` module to wrap this Lock Widget usage and manage the localStorage items.
I'm using the latest Auth0 Lock 10 version in [popup mode](https://auth0.com/docs/libraries/lock/v11/authentication-modes#popup-mode), which means here's the flow:
* ->Login widget shows login panel
* ->Redirect to auth0 to check login creds (done in hidden iframe)
* ->Redirect back to localhost:3000/callback (done in hidden iframe)
* ->AuthService waits for 'authenticated' event to fire
* ->Redirects back to homepage
### Libraries
This starter kit is minimal, only the strict necessary is added.
| Library | Description |
| ------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| [react](https://github.com/facebook/react) | Facebook's library for building user interfaces |
| [redux](https://github.com/rackt/redux) | State container for JavaScript apps |
| [react-router](https://github.com/rackt/react-router) | Declarative routing for React apps using navigational components |
| [create-react-app](https://github.com/facebookincubator/create-react-app) | All tooling needed for react apps |
The starter kit includes a working example app that puts all of the above to use.
## Development
`create-react-app` takes care of tooling, development server, live reload, building, testing.
HMR is unfortunately not enabled during development, because `create-react-app` doesn't support it.
If you wish to directly use Webpack instead of `create-react-app`, you can eject any time by running `npm run eject`. Read [here](https://github.com/facebookincubator/create-react-app#converting-to-a-custom-setup) for more information about ejecting.
## Testing
`npm run lint` to check linting errors. This projects follows [`eslint-config-react-app`](https://github.com/facebookincubator/create-react-app/tree/master/packages/eslint-config-react-app) style.
`npm test` to run all tests. This project uses jest to run tests, and [enzyme](https://github.com/airbnb/enzyme) for unit testing React components.
## Deployment
Out of the box, this starter kit is deployable by serving the `~/build` folder generated by `npm run build`.
## License
MIT. See LICENSE file.
## Future ideas
* [ ] Add a side effects library (`redux-saga`, `redux-observable`) to manage side effects. It makes the code more redux-compliant, however it goes against minimalism.
* [ ] Any other ideas are welcome! Just post an issue.
## Donations
If you like this project, I would really appreciate small donations. Here's my Ethereum address: 0xa395447BF15f7525484C0378c76627D45ADE0B96.