DEV Community

Cover image for Authentication using AuthGrid

Authentication using AuthGrid

nirberko profile image Nir Berko ・3 min read

Notice that AuthGrid is not yet ready for production environment and is still in progress!

What is AuthGrid

AuthGrid is an end-to-end open source authentication provider (both server-side and client-side) that lets you focus on your app and skip the boring and time-wasting authentication development. Forget about creating that login and register pages again and again. forget about creating a profile page, user settings, webhooks, integrations, audits, and more!

How to use AuthGrid?

First of all, AuthGrid currently supporting only express.js for the backend, React in the frontend, and mongoose as a database, but more frameworks and databases will be supported in the future!

for our example, I'll be building a dashboard application using the express.js framework for my backend, MongoDB (using mongoose) for the database, and React for the client-side.

installing AuthGrid for backend

we need to add AuthGrid middleware to our express backend, and also to install the database driver that matches our needs, in that case, we need to install the AuthGrid mongoose driver

Let's install both AuthGrid client the mongoose driver to our express backend

npm install @authgrid/client @authgrid/mongoose-driver
Enter fullscreen mode Exit fullscreen mode

or using yarn

yarn add @authgrid/client @authgrid/mongoose-driver
Enter fullscreen mode Exit fullscreen mode


first of all, we need of course to configure mongoose with our mongodb database connection uri, for example:

await mongoose.connect(String('mongodb://localhost:27017/my_dashboard'));
Enter fullscreen mode Exit fullscreen mode

then, implementing AuthGrid is very simple, just add AuthGrid client middleware at the beginning of your express app:

import AuthGrid from '@authgrid/client';
import MongooseDriver from '@authgrid/mongoose-driver';


    driver: MongooseDriver(),  
    tokenSecret: ...,  
    refreshTokenSecret: ...,  
    mailer: ...,  
Enter fullscreen mode Exit fullscreen mode

notice that AuthGrid requires some options, so let's explore than now:

Driver is the way AuthGrid client communicating with our database. in our example, we are using MongoDB, so we need to import @authgrid/mongoose-driver
tokenSecret and refreshTokenSecret are very important and are using by AuthGrid to create hashed tokens for authenticating the users.
mailer is the way AuthGrid can send emails, this function will be called everytime AuthGird wants to send an email, for example, this is how im using SendGrid as my email provider:

const mailer = async ({ to, subject, html }) =>  
    from: '',  
Enter fullscreen mode Exit fullscreen mode

we almost done,
last thing we need to do is to protect our api using the withAutentication middleware provided by AuthGrid.
this is how we do it:

app.get('/get-user-details', withAuthentication(), (req, res) => {  
Enter fullscreen mode Exit fullscreen mode

installing AuthGrid for React.js

So now that our express.js backend is ready and protected, lets move to the client-side.
AuthGrid providing us also a very powerful client-side authentication components and state management.
let's see how we can use those pre-made components by AuthGrid.

First, we need to install the AuthGrid package for react

npm install @authgrid/react-core
Enter fullscreen mode Exit fullscreen mode

or using yarn

yarn add @authgrid/react-core
Enter fullscreen mode Exit fullscreen mode


so now that we have the AuthGrid react-core package installed, we need to warp our whole component with the AuthGrid provider.

import React from 'react';  
import ReactDOM from 'react-dom';  
import { BrowserRouter, Switch } from 'react-router-dom';  
import { AuthgridProvider, ProtectedRoute, useAuth } from '@authgrid/react-core';  

const context = {  
  baseUrl: 'http://localhost:8080',  

const Home = () => {  
  const { user } = useAuth();  

  return <div>{user?.email}</div>;  

    <AuthgridProvider context={context}>  
        <ProtectedRoute path="/" component={Home} />  
Enter fullscreen mode Exit fullscreen mode

as you can see, we need to provide AuthGrid the base URL for our server-side, this is very important so AuthGrid can know where to send the fetch requests.

also, for protecting routes only for authenticated users we can import the ProtectedRoute component. now, when a user wants to enter that route, he must log in before.

That's it, we are done!, now, let's check our application and see that everything is working.
when you enter your app, you should see the AuthGrid login screen (don't forget to use the ProtectedRoute component)


You can now register and login into your application!

Keep in mind that AuthGird is still at work and can be a bit buggy, and a lot of features are missing and will be added in the future with the help of the community.
so I'm not recommending using this package yet, follow the repo to be updated when AuthGrid is ready to use in production environments

AuthGrid is looking for contributors (and that also the reason I published this post :)) so contact me if you are interesting :)

A lot of features are yet to come!:

  • Profile and settings page
  • Audits logs
  • Webhooks
  • Integrations
  • User management
  • and much more...

Discussion (0)

Editor guide