Getting Started

Welcome to AppBoost! 👋

The complete Expo React Native starter template with everything you need to launch your mobile app faster.

Prerequisites

Before you begin, ensure you have:

• Node.js (v18 or later)
• npm
• Git
• Claude Code (recommended) - Install here 

Step 1: Clone the Repository

git clone https://github.com/samuel-yost-org/AppBoost.git my-app
cd my-app
git remote remove origin

Step 2: Install Dependencies

npm install

Step 3: Configure Services

Option A: Interactive Setup with Claude Code (Recommended) or Cursor

The easiest way to configure AppBoost is using the built-in /appboost setup wizard:

With Claude Code:

claude

With Cursor: Press Cmd+L (Mac) or Ctrl+L (Windows) to open the AI chat.

Then run the setup command:

/appboost

The wizard will guide you through configuring:

• App settings - Name, bundle IDs, and basic configuration
• Supabase - Authentication, database tables, and RLS policies
• RevenueCat - In-app purchases and subscriptions
• Push notifications - Expo push notification setup
• PostHog - Analytics setup

You can configure all services at once or skip any for later. The wizard can also set up MCP servers for Supabase and RevenueCat, allowing the AI to directly manage your backend and products.

Option B: Manual Configuration

Create a .env file in the root directory using the .env.example for reference.

For detailed manual setup, see:

• General Configuration - App name, bundle IDs, and basic settings
• Supabase Configuration - Auth, database, and real-time
• RevenueCat Configuration - Payments and subscriptions
• Push Notifications - Expo push notification setup
• PostHog Analytics - Analytics and feature flags

Step 4: Running the App

Option A: Development Build (Recommended)

For full native features, use EAS Build:

1. Install EAS CLI:

npm install --global eas-cli

2. Build for your platform:

eas build --profile development --platform ios   # or android

3. Install on your device

4. Start the development server:

npx expo start

Option B: Local Build

# Android
npx expo run:android
 
# iOS (macOS only)
npx expo run:ios

Troubleshooting

”expo module not installed” error

Run npm install in the project directory.

Android SDK not found

Use EAS Build instead:

eas build --profile development --platform android

Dependencies issues

Clear cache and reinstall:

rm -rf node_modules
npm cache clean --force
npm install

Build Profiles