First App Launch

Now that you have the boilerplate installed and your tools configured, let's set up your environment variables and launch the app.

Step 1: Configure Environment Variables

Create a .env file in the project root:

cp .env.example .env

Edit .env with your credentials from the tools you configured:

# Supabase (Required)
EXPO_PUBLIC_SUPABASE_URL=https://your-project.supabase.co
EXPO_PUBLIC_SUPABASE_ANON_KEY=your-anon-key-here

# App Environment (Defaults to development)
EXPO_PUBLIC_APP_ENV=development

# Google Auth
# IOS Client ID is required by validation (use dummy if not ready)
EXPO_PUBLIC_GOOGLE_IOS_CLIENT_ID=dummy-value-for-dev
EXPO_PUBLIC_GOOGLE_WEB_CLIENT_ID=

Why the dummy value? The project's strict type validation (src/config/env.ts) requires a Google Client ID to start. You can replace this with your real ID later when setting up Social Auth.

Plaintext


> **Security Note:** Never commit `.env` to version control. The `.env.example` file is for reference only.

**Where to get these values:**
- [Supabase Setup](/docs/first-app-launch/supabase)
- [Firebase Setup](/docs/first-app-launch/firebase)
- [RevenueCat Setup](/docs/first-app-launch/revenuecat)

## Step 2: Start Development Server

```bash
yarn start

This opens Expo DevTools in your terminal.

Step 3: Launch Your App

For iOS (macOS only):

yarn ios

For Android:

yarn android

For Web (testing only):

yarn web

Verify Installation

Your app should now be running. You should see:

Expo DevTools running in your terminal
App running in simulator/emulator
No errors in terminal

If you see the welcome/onboarding screen, you're all set!

Available Commands

# Development
yarn start              # Start Expo dev server
yarn ios                # Run on iOS simulator
yarn android            # Run on Android emulator
yarn dev:ios            # Validate & run iOS
yarn dev:android        # Validate & run Android

# Code Quality
yarn lint               # Fix linting issues & type check
yarn lint:check         # Check without fixing
yarn type:check         # TypeScript validation
yarn format             # Format code with Biome
yarn test               # Run tests
yarn test:watch         # Run tests in watch mode

# Building
yarn build:ios:dev      # Build iOS development
yarn build:android:dev  # Build Android development
yarn build:prod         # Build production for both platforms

# Utilities
yarn clean              # Clean cache, deps, builds
yarn validate           # Type check + lint + test
yarn i18n:check         # Check translations

Having issues? Check our Troubleshooting Guide

First App Launch

First App Launch

Step 1: Configure Environment Variables

Step 3: Launch Your App

Verify Installation

Available Commands

On this page