Version 2 or React Native Navigation is a rewrite of the library, addressing some issues that arose from the initial release.
In this tutorial, we’ll show how to build a real-world authentication flow, simulating authentication state using AsyncStorage that can be replaced with whatever authentication provider you choose.
The value we get out of using an authentication flow as a demo is that we’ll get to look at a fairly large surface of the React Native Navigation API, working with both stack & tab based navigation, & will also be seeing how to solve an actual problem when building out an application: structuring the navigation for user authentication considerations.
How the flow will work:
- When the application loads we’ll render an initial Initializing component while checking to see if there is a user available in storage.
- If there is a user in storage, we’ll render the Home route in a stack-based navigation.
- If there is not a user in storage, we’ll render the auth components (SignIn & SignUp) in a tab-based navigation.
This is part 1 of a 2 part series.
Part 1 — Creating end-to-end navigation & authentication flow with dummy authorization for use with any Auth provider.
To get started, we first need to create a new React Native project using the React Native CLI:
react-native init RNNav2
Next, we’ll use npm or yarn to install React Native Navigation
npm install react-native-navigation@alpha
We’ll now need to link the native dependencies & add some native code.
For details on how to integrate on iOS, click here.
For details on how to integrate on Android, click here.
Creating the files
Next, we’ll create the files we’ll need for this app.
Let’s create a
src folder in our root directory to hold everything:
Next, let’s create the following files in the
touch config.js Home.js Initializing.js SignIn.js SignUp.js screens.js navigation.js Screen2.js
config.js — this file will hold some basic configuration for our app, in our case it will be an AsyncStorage key for retrieving the user from storage.
Home.js — this file will hold the component that renders if the user is logged in.
Initializing.js — this file will hold the initialization logic and display a message to the user that the app is loading.
Signin.js / SignUp.js — These will hold the forms for signing in & signing up.
SignIn.js will also redirect a signed in user to the Home screen.
screens.js — this file will hold the screen configuration for React Native Navigation.
navigation.js — this file will hold our navigation functions. We’ll have two main functions:
Screen2.js — this will just hold another component for us to navigate to from our Home screen to demonstrate stack navigation.
Registering the screens
With React Native Navigation, we need to register each of the screens that we will be using in our app.
To do so, we’ll use the
registerComponent method from React Native Navigation. We’ll place all of the screens we like to initialize into a single function, & call the function before creating the root of our navigation:
Here, we create & export a function that calls
Navigation.registerComponent() on any components we would like to have available to our Navigation.
Registering the app
Next we’ll update
index.js to set up & initialize the application’s beginning navigation stack.
Here, we import the
registerScreens function & invoke it.
We also set the initial root stack of our app by calling
Navigation.setRoot, passing in the initial routes we would like our application to render. In our case, the root will be a single component, the
Creating our Navigation functions
Now, let’s create a couple of reusable functions that we can use to set root route stacks from within our app.
The root route is what defines the original route stack. We will want to have the option to reset the root stack to either the Authorization routes the actual App itself if the user is logged in.
The images we are requiring for our tabs are below, feel free to save them & use them:
navigation.js there are two functions:
goToAuth — This function sets our root route stack to a
bottomTabs route configuration. Each tab is a component, with a name and some options configured.
goHome — This sets the route stack to a
stack navigation, passing in a single component to the children array: the
Storing the AsyncStorage key in a config file
We will be checking AsyncStorage to see if the user is signed in, and will be doing so in multiple files. We’ll store the AsyncStorage key in a separate file so we can reuse it easily.
Creating our screens
Now we have created all of the navigation configuration we will need, let’s create the screens & components we will be using.
Initializing.js — If you look at
componentDidMount, you will see most of what is going on here. We check AsyncStorage to see if we have a user saved in storage, if so we load the
Home screen, if not we load the
Auth routes (SignIn & SignUp).
componentDidMount is running the logic to see if a user is saved in storage, we show a Loading message. We then reset the route stack based on whether a user exists.
Home.js — Here, we render a basic message to the user, and give them the option to either sign out or navigate to another route.
One difference & something I would note is how we are calling navigation methods. Instead of using props like in the old version (
this.props.navigator.push), we’re importing the
Navigation API and calling
You’ll also notice a static
get options() class function. You can add this to your screen React component definition to add styling & properties to your navigator appearance. In ours, we’ve just given the
topBar a title property.
Screen.js — This is a really basic screen that we have only to demonstrate navigation in a stack navigator from our Home screen. One thing to note is how we call the Navigation.pop function to go back. This is again different from the old API that used props (
this.props.navigator.pop) vs in V2 we’re using the imported
Navigation API from React Native Navigation (
SignUp.js — For now, SignUp.js is just a placeholder signup form. You can use this to implement whatever Authentication service you are using. In part 2, we will be updating this to be a real-world signup form using AWS Amplify & Amazon Cognito.
SignIn.js — This component holds a basic sign in form. In the
signIn class method we simulate a successful sign in by setting the username property in
AsyncStorage & the navigating the user to the Home screen.
Now we should be able to run the app:
The final code for this project up to here is located here.
To view part 2 of this tutorial, click here.
My Name is Nader Dabit . I am a Developer Advocate at AWS Mobile working with projects like AWS AppSync and AWS Amplify, and the founder of React Native Training.
If you enjoyed this article, please clap n number of times and share it! Thanks for your time.