npx create-solito-app@latest my-solito-app
This monorepo is a blank(ish) starter for an Expo + Next.js app.
This monorepo also includes react-native-firebase
for native and firebase JS SDK for web.
While it's pretty barebones, it does a lot of the annoying config for you. The folder structure is opinionated, based on my long experience building for this stack. You need to create a Firebase project and configure your project based ont this guide.
solito
for cross-platform navigationmoti
for animationsdripsy
for theming/design (you can bring your own, too)- Expo SDK 46
- Next.js 12
- React Navigation 6
-
apps
entry points for each appexpo
next
-
packages
shared packages across appsapp
you'll be importing most files fromapp/
features
(don't use ascreens
folder. organize by feature.)provider
(all the providers that wrap the app, and some no-ops for Web.)navigation
Next.js has apages/
folder. React Native doesn't. This folder contains navigation-related code for RN. You may use it for any navigation code, such as custom links.
You can add other folders inside of packages/
if you know what you're doing and have a good reason to.
-
Install dependencies:
yarn
-
Next.js local dev:
yarn web
- Runs
yarn next
- Runs
-
Expo local dev:
yarn native
- Runs
expo start
- Runs
If you're installing a JavaScript-only dependency that will be used across platforms, install it in packages/app
:
cd packages/app
yarn add date-fns
cd ../..
yarn
If you're installing a library with any native code, you must install it in apps/expo
:
cd apps/expo
yarn add react-native-reanimated
cd ../..
yarn
You can also install the native library inside of packages/app
if you want to get autoimport for that package inside of the app
folder. However, you need to be careful and install the exact same version in both packages. If the versions mismatch at all, you'll potentially get terrible bugs. This is a classic monorepo issue. I use lerna-update-wizard
to help with this (you don't need to use Lerna to use that lib).
Follow Fernando Rojo on Twitter: @FernandoTheRojo
See my talk about this topic at Next.js Conf 2021: