Getting Started with the React Native
ABP Commercial platform provides a basic React Native template to develop mobile applications integrated to your ABP based backends.
When you create a new application as described in the getting started document, the solution includes the React Native application in the
react-native folder as default.
Configure Your Local IP Address
A React Native application running on an Android emulator or a physical phone cannot connect to the backend on
localhost. To fix this problem, it is necessary to run backend on your local IP address.
Add application to database
Since ABP version
7.4react native uses authorization code flow, you need to add an application to the database for the mobile application. ABP will create a client for the mobile application. You can use the
DbMigratorproject to add an application to the database. You can find the
DbMigratorproject in the
- Open the
appsettings.jsonfile in the .DbMigrator folder. Replace the
localhostaddress on the
ProjectName_Mobileproperty with your local IP address.
You should turn off the "Https Restriction" if you're using OpenIddict as a central identity management solution. Because the IOS Simulator doesn't support self-signed certificates and OpenIddict is set to only work with HTTPS by default.
How to disable the Https-only settings of OpenIddict
Go to MyProjectNameHttpApiHostModule.cs under the host project. Add put this code snippet under the
Run the Server Application
Run the backend application as described in the getting started document.
React Native application does not trust the auto-generated .NET HTTPS certificate, you should use the HTTP during development.
Go to the
react-native folder, open a command line terminal, type the
yarn command (we suggest to the yarn package manager while
npm install will also work in most cases):
- Open the
Environment.jsfile in the
react-nativefolder and replace the
localhostaddress of the
issuerproperties with your local IP address as shown below:
Make sure that
apiUrlmatch the running address of the
.Blazor(BlazorServer UI) projects.
Once all node modules are loaded, execute
yarn start (or
npm start) command:
Wait Expo CLI to start. Expo CLI opens the management interface on the
In the above management interface, you can start the application with an Android emulator, an iOS simulator or a physical phone by the scan the QR code with the Expo Client.
Enter admin as the username and 1q2w3E* as the password to login to the application:
The application is up and running. You can continue to develop your application based on this startup template.
- For the UI theme ABP uses react-native-paper
- Also expo-image-picker, react-native-root-toast and some libraries are used in the project.
Thank you for your valuable feedback!
Please note that although we cannot respond to feedback, our team will use your comments to improve the experience.