Install dependencies, configure your backend, and run ScaleRocket Mobile on your device.

Setup

Get your ScaleRocket Mobile app running locally in minutes.

1. Install Dependencies

git clone <your-repo-url>
cd scalerocket-mobile
npm install

Copy the example env file and add your Supabase credentials:

cp .env.example .env

Edit .env:

EXPO_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
EXPO_PUBLIC_SUPABASE_ANON_KEY=eyJ...your-anon-key

Find these values in your Supabase dashboard under Settings > API.

Then configure your Supabase project:

Auth — Email/password is enabled by default
Google OAuth (optional) — Configure in Authentication > Providers
Apple Sign-In (optional) — Configure in Authentication > Providers
Redirect URL — Add scalerocket:// to Authentication > URL Configuration > Redirect URLs

Copy the example env file:

cp .env.example .env

Set up Convex:

npx convex dev

This will prompt you to log in and create a new project. The CLI automatically populates your .env with the deployment URL.

EXPO_PUBLIC_CONVEX_URL=https://your-project.convex.cloud

Start the Expo development server:

npx expo start

This shows a QR code in the terminal.

Dev builds include native modules that Expo Go does not support (like SecureStore).

npm install -g eas-cli
eas login
eas build --platform ios --profile development
eas build --platform android --profile development

Install the resulting build on your device, then run:

npx expo start --dev-client

npx expo start --ios       # Requires Xcode (macOS only)
npx expo start --android   # Requires Android Studio

First-time EAS configuration:

npm install -g eas-cli
eas login
eas build:configure

This generates/updates eas.json with three build profiles:

Your .env file is missing or the values are empty. Verify the file exists and contains valid keys.

SecureStore requires a development build. Use eas build --profile development instead of Expo Go.

Check that you are logged in (eas whoami) and your project is linked (eas build:configure).