Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/the-road-to-react-with-firebase/react-firebase-authentication
🔥 Boilerplate Project for Authentication with Firebase in React.
https://github.com/the-road-to-react-with-firebase/react-firebase-authentication
authentication authorization create-react-app firebase firebase-auth firebase-authentication firebase-database firebase-db protected-routes react react-router-4 react-router-v4 react-router4 reactjs
Last synced: 6 days ago
JSON representation
🔥 Boilerplate Project for Authentication with Firebase in React.
- Host: GitHub
- URL: https://github.com/the-road-to-react-with-firebase/react-firebase-authentication
- Owner: the-road-to-react-with-firebase
- Created: 2017-09-11T06:22:23.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2022-09-08T00:54:52.000Z (over 2 years ago)
- Last Synced: 2024-12-30T06:05:44.865Z (13 days ago)
- Topics: authentication, authorization, create-react-app, firebase, firebase-auth, firebase-authentication, firebase-database, firebase-db, protected-routes, react, react-router-4, react-router-v4, react-router4, reactjs
- Language: JavaScript
- Homepage: https://www.robinwieruch.de
- Size: 667 KB
- Stars: 1,016
- Watchers: 27
- Forks: 295
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
Awesome Lists containing this project
- jimsghstars - the-road-to-react-with-firebase/react-firebase-authentication - 🔥 Boilerplate Project for Authentication with Firebase in React. (JavaScript)
README
# react-firebase-authentication
[](https://travis-ci.org/the-road-to-react-with-firebase/react-firebase-authentication) [](https://slack-the-road-to-learn-react.wieruch.com/) [](https://greenkeeper.io/)
* [Tutorial](https://www.robinwieruch.de/complete-firebase-authentication-react-tutorial/)
## Variations
* [Redux Version](https://github.com/the-road-to-react-with-firebase/react-redux-firebase-authentication)
* [MobX Version](https://github.com/the-road-to-react-with-firebase/react-mobx-firebase-authentication)
* [Gatsby Version](https://github.com/the-road-to-react-with-firebase/react-gatsby-firebase-authentication)
* [Firestore Version](https://github.com/the-road-to-react-with-firebase/react-firestore-authentication)
* [Semantic UI Version](https://github.com/the-road-to-react-with-firebase/react-semantic-ui-firebase-authentication)
## Features
* uses:
* only React (create-react-app)
* firebase
* react-router
* features:
* Sign In
* Sign Up
* Sign Out
* Password Forget
* Password Change
* Verification Email
* Protected Routes with Authorization
* Roles-based Authorization
* Social Logins with Google, Facebook and Twitter
* Linking of Social Logins on Account dashboard
* Auth Persistence with Local Storage
* Database with Users and Messages
## License
### Commercial license
If you want to use this starter project to develop commercial sites, themes, projects, and applications, the Commercial license is the appropriate license. With this option, your source code is kept proprietary. Purchase an commercial license for different team sizes:
* [1 Developer](https://gum.co/react-with-firebase-starter-pack-developer)
* [Team of up to 8 Developers](https://gum.co/react-with-firebase-starter-pack-team)
* [Unlimited Developers of an Organization](https://gum.co/react-with-firebase-starter-pack-organization)
It grants you also access to the other starter projects in this GitHub organization.
### Open source license
If you are creating an open source application under a license compatible with the [GNU GPL license v3](https://www.gnu.org/licenses/gpl-3.0.html), you may use this starter project under the terms of the GPLv3.
## Installation
* `git clone [email protected]:the-road-to-react-with-firebase/react-firebase-authentication.git`
* `cd react-firebase-authentication`
* `npm install`
* `npm start`
* visit http://localhost:3000
Get an overview of Firebase, how to create a project, what kind of features Firebase offers, and how to navigate through the Firebase project dashboard in this [visual tutorial for Firebase](https://www.robinwieruch.de/firebase-tutorial/).
### Firebase Configuration
* copy/paste your configuration from your Firebase project's dashboard into one of these files
* *src/components/Firebase/firebase.js* file
* *.env* file
* *.env.development* and *.env.production* files
The *.env* or *.env.development* and *.env.production* files could look like the following then:
```
REACT_APP_API_KEY=AIzaSyBtxZ3phPeXcsZsRTySIXa7n33NtQ
REACT_APP_AUTH_DOMAIN=react-firebase-s2233d64f8.firebaseapp.com
REACT_APP_DATABASE_URL=https://react-firebase-s2233d64f8.firebaseio.com
REACT_APP_PROJECT_ID=react-firebase-s2233d64f8
REACT_APP_STORAGE_BUCKET=react-firebase-s2233d64f8.appspot.com
REACT_APP_MESSAGING_SENDER_ID=701928454501
```
### Activate Sign-In Methods
* Email/Password
* [Google](https://www.robinwieruch.de/react-firebase-social-login/)
* [Facebook](https://www.robinwieruch.de/firebase-facebook-login/)
* [Twitter](https://www.robinwieruch.de/firebase-twitter-login/)
* [Troubleshoot](https://www.robinwieruch.de/react-firebase-social-login/)
### Activate Verification E-Mail
* add a redirect URL for redirecting a user after an email verification into one of these files
* *src/components/Firebase/firebase.js* file
* *.env* file
* *.env.development* and *.env.production* files
The *.env* or *.env.development* and *.env.production* files could look like the following then (excl. the Firebase configuration).
**Development:**
```
REACT_APP_CONFIRMATION_EMAIL_REDIRECT=http://localhost:3000
```
**Production:**
```
REACT_APP_CONFIRMATION_EMAIL_REDIRECT=https://mydomain.com
```
### Security Rules
```
{
"rules": {
".read": false,
".write": false,
"users": {
"$uid": {
".read": "$uid === auth.uid || root.child('users/'+auth.uid).child('roles').hasChildren(['ADMIN'])",
".write": "$uid === auth.uid || root.child('users/'+auth.uid).child('roles').hasChildren(['ADMIN'])"
},
".read": "root.child('users/'+auth.uid).child('roles').hasChildren(['ADMIN'])",
".write": "root.child('users/'+auth.uid).child('roles').hasChildren(['ADMIN'])"
},
"messages": {
".indexOn": ["createdAt"],
"$uid": {
".write": "data.exists() ? data.child('userId').val() === auth.uid : newData.child('userId').val() === auth.uid"
},
".read": "auth != null",
".write": "auth != null",
},
}
}
```