Create Tamagui App
Get started with helpful templates
Set up a starter repo to help learn about and/or bootstrap your tamagui app:
Currently, we have two template available:
starter-freeExpo, Expo Router, Solito and Next.js (with both
simple-web(recommended for learning) Client-only web app with Webpack or Vite. Useful to understand how to set up tamagui.config.ts.
npm create tamagui
Check out the source of the templates .
To run the app:
cd myappyarnyarn web # Web local devyarn native # Expo local dev (only for `starter-free`)
📦 Included packages (
tamaguifor cross-platform views, themes and animations
solitofor cross-platform navigation
expo-routerfor having same routing concepts between web and native
- Expo SDK 48
- Next.js 13
Next.js you can enjoy the power and simplicity of creating universal apps.
🗂 Folder layout
appsentry points for each app
packagesshared packages across apps
appyou'll be importing most files from
features(don't use a
screensfolder. organize by feature.)
provider(all the providers that wrap the app, and some no-ops for Web.)
navigationonly for starter-free template, contains the navigation code for RN
You can add other folders inside of
packages/ if you know what you're doing and have a good reason to.
🏁 Start the app
Next.js local dev:
Expo local dev:
🆕 Add new dependencies
Pure JS dependencies
cd packages/appyarn add date-fnscd ../..yarn
If you're installing a library with any native code, you must install it in
cd apps/expoyarn add react-native-reanimatedcd ../..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).