Project template for mobile app projects using React Native and Expo (via Prebuild).
Make sure your development environment is setup and up-to-date by following this guide.
After you have cloned this repo to start a new mobile app project go through the following steps to customize the template based on your project needs.
Update the following fields in the config/app.config.ts:
appId(the id of the app, usually the bundle identifier. For example:com.mynewapp. Keep theappIdSuffixlogic as it is)slug(this is really not used but Expo requires it)name(name of the app)scheme(the url scheme used to open the app from a link)
Follow this CICD guide.
- If you don't have a design system yet clone the Design System Template project in Figma.
- Update the design tokens (colors, typography, etc.) to match your project design and branding.
- Add your own app icon in the App Icon & Splash page. Use the import areas to import the iOS and Android icons (they need different sizes)
- Run
npm run design-system:syncin the terminal.
A more detailed guide on how to setup a design system can be found here. For fonts & assets check this.
Follow this Publishing guide.
Context: to counter one 1 ⭐ rating we need 7 x 5 ⭐ to have an average of 4.5 ⭐.
If the app is customer facing and published to App Store or Google Play you should setup app reviews. This allows users to rate the app and give feedback. The reviews are then visible in the store and can be used to improve the app.
- Setup app reviews in App Store Connect and Google Play Console.
- Update the
(dev|test|stag|prod.config.tswith the app store and google play urls. (only prod will allow you to actually rate the app, the rest is for testing purposes) - Mode the
StoreReviewcomponent to a more appropriate place in your app. - Make sure to collect the user feedback in the backend or have it sent to you via email or some other channel.
Note: It’s crucial to time well the moment when we ask a user for their feedback. It’s best to ask for a review after a positive action. For example, after completing a level, uploading a post, or making a purchase. As the template is basically a blank app, this guideline is not respected. Move the review request to a more appropriate place in your app.
Important: It’s also important to be mindful of how often we ask for review. The App Store only lets you do it 3 times a year. Make sure not to exceed this limit. The current implementation makes sure we don't ask for review after the user has been to the rating modal (We cannnot know if they actually submitted their review or not). If you want to ask for review more often you need to change the logic in the StoreReview component.
Note: currently we use async storage to store when the last review was done. This means that if the user uninstalls the app and reinstalls it, we will ask for review again. Ideally we would store this information in the backend.
More information on how to setup app reviews can be found here.