The new Cosmic dashboard is now available in private beta 🎉
Get it now →

How to build a React Auth App using React, Cosmic and Node

Community Articles
Community Articles How to build a React Auth App using React, Cosmic and Node

TL;DR

Download the GitHub repo.
Check out the demo.

Prerequisites

Environment:

You will be required to install node.js and npm before starting. Make sure you already have them installed on your machine.


Technology Stack

  1. Cosmic: Cosmic is used for API management.
  2. ReactJS: ReactJS is used to connect frontend app with Cosmic. React v16 is used which is based on React Fiber and it makes the app faster and lighter than React v15.
  3. NodeJS: NodeJS is used handle endpoints such as communicating with Cosmic using private settings & sending emails using gmail SMTP client service.
  4. NextJS: NextJS v4 is used to make the app server-side rendered.

Getting Started

In this repository, we are going to build an app that would demonstrate everything that is included in basic authentication app.


Setup Bucket:

To create the bucket, login to Cosmic and click on 'Add New Bucket' .


Select 'Start from scratch'


Import Bucket Data:

Download this React Auth App Bucket JSON file and go to your Cosmic Dashboard. Now on the sidebar, go to Settings -> Import / Export Data  and click on 'Add Import File'  and choose the downloaded file. It will import all the Object Types and required data.


Now let's get started with the actual application.


Cosmic Configuration

After downloading the react-auth-app repository, do npm install in the terminal. After installing all the dependencies, we need to setup the cofiguration for Cosmic. For that, we will clone .env.example and rename it as .env and setup all the variables in it with our bucket configuration.

.env would look like the file listed below


Private Settings

You need to add a single entry for private-settings which would include the following:

Title: some dummy test

Email Username: your gmail account email.

Email Password: your gmail account password.

FROM EMAIL: your email from which the notification emails would be sent.

Note: We are using SMTP gmail client to send emails.


Now you are all setup to run the app.

Workflow

Pages:

  1. Login - This page is used to login the user
    1. Route: /
    2. Failures
      1. This would fail if either email or password is incorrect.
      2. This would fail if the account is not verified.
    3. Success
      1. This would succeed only if the credentials are correct and the account is activated.
  2. Signup - This page is used to register the user and the verification email is sent to respective email
    1. Route: /signup
  3. Profile - This page is used to list profile information
    1. Route: /profile
  4. Edit Profile - This page is used to edit profile information
    1. Route: /profile/edit
  5. Edit Password - This page is used to edit account password
    1. Route: /profile/edit/password
  6. Forgot Password - This page is used to send an OTP for resetting password to an email
    1. Route: /forgotPassword
  7. Reset Password - This page is used to reset password with an OTP sent to a respective email
    1. Route: /resetPassword
  8. Activate Account: This page is used to activate account
    1. Route: /activateAccount


Details:

Login:


Signup:

Profile:

Edit Profile:

Edit Password:

Forgot Password:

Reset Password:

Activate Account:


Security

This app used MD5 encryption to encrypt the password and match the encrypted password while logging in. To maintain authenticated scenarios, we used JWT tokenization to tokenize the information and store them into cookies. 


Conclusion

This is a basic app covering all basic features of authentication that were listed above too. We also followed security measures like encryption of information and passwords. I hope you like the tutorial to get started with this app and find it useful. Cheers. Happy Coding.

You may also like


Add the power of Algolia search to your Bucket. This Extension enables you to sync your Cosmic Objects with Algolia, making your data searchable. Set up automatic syncing to automatically add / edit / remove content from Algolia. Follow the simple steps below to install and setup Algolia.
An application for book lovers to view a list of their favorite books.
This is a quick example to show some of the powerful things you can do with the Cosmic NPM Module. This script will, add a Bucket to your Cosmic account, add an Object Type (Pages) and add a few Pages.
Step by step guide to creating a Cosmic extension that imports data
In this tutorial, I'm going to show you how to create a minimalistic but awesome single page app blog using Vue, Vuex, Vuetify, Cosmic and deploy it to Netlify.
In this video, Cosmic co-founder Tony Spiro takes you on a tour of the new Cosmic CLI which allows you to do all of the awesome things you can with the Cosmic API, from the comfort of your command line interface.

Get started with Cosmic

Personal projects are free. Scale up as you grow.
Start building Talk to sales