Getting started

Install and run

Install dependencies and run the Starter Kit on iOS or Android.

You need Node 20+, pnpm or npm, Xcode (iOS), and Android Studio (Android). Expo Go is not enough — Firebase, RevenueCat, and OneSignal need a dev client / native build.

1. Install

cd codebasehubv4
cp .env.example .env.local
npm install

Fill .env.local as you add services. The app boots without every key, but those features stay inactive until the matching env var and flag are set.

2. Native config files

Replace the placeholder Firebase files with your own project:

  • GoogleService-Info.plist (iOS)
  • google-services.json (Android)

Keep the same filenames and paths. app.json already points at them.

3. Run

# Start Metro
npm start

# First time, or after changing native plugins:
npm run prebuild
npm run ios
npm run android

prebuild regenerates ios/ and android/ from app.json. After that, npm run ios / npm run android build the native app with a dev client.

Useful scripts:

ScriptWhat it does
npm startMetro bundler (expo start --clear)
npm run ios / androidNative debug build
npm run prebuildClean Expo prebuild
npm run eas:ios / eas:androidCloud build
npm run eas:submit:ios / androidStore submit

Next: put the project on your GitHub, then rename it.

On this page