Skip to content


React Auth Kit uses React's Context Provider to maintain it's internal state in the application. So to use auth kit, you must have to add the AuthProvider on the very top level of your application. Without the provider the application will fail to work and will throw errors.


AuthProvider is the top level context provider for React Auth Kit. By passing various props in the AuthProvider, you can configure the behaviour of React Auth Kit.


import { AuthProvider } from 'react-auth-kit'


Integrate AuthProvider before Routes. The best place is app.js.

import React from 'react';
import { AuthProvider } from 'react-auth-kit'
import RouteComponent from './routes';

const App = () => (
    <AuthProvider authType = {'cookie'}
                  cookieSecure={window.location.protocol === "https:"}>
        <RouteComponent />

export default App;


AuthProvider should wrap the BrowserRouter or HashRouter, otherwise PrivateRoute will not work and throw an error.


If you are using the Refresh Token feature, then you must have to add the refresh prop with proper value, otherwise refresh token will throw a not implemented error. If you are not using the Refresh Token feature, then don't add it


Name Type Default Description
children node The content of the component
authType 'localstorage' | 'cookie' 'cookie' The type of the auth storage. In localstorage, the tokens store in localStorage. In cookie, the tokens store in cookies.
authName string '_auth' The prefix for the name of the storage, which stores the auth token. Applicable for both cookies and localStorage.
refresh createRefreshParamInterface (optional) If you are using refresh token, then add this prop. The value of the props must be the return value of createRefresh (See Here. If you are not using refresh token, then leave the prop)
cookieDomain string (optional) <current hostname> The Domain name for cookie. ⚠ If authType is cookie, then you must put a value. More Info about Cookie Domain
cookieSecure boolean (optional) <current protocol> The cookie secure flag. ⚠ If authType is cookie, then you must put a value. More Info about Cookie Security

— 🔑 —

React Auth Kit is Apache 2.0 License code