Supabase Setup

Supabase provides authentication, database, and real-time features for your app. This guide covers the complete setup.

Quick Start with Claude Code (Recommended)

The easiest way to set up Supabase is using the interactive wizard:

claude

Then run:

/appboost

The wizard will:

• Guide you through creating a Supabase project
• Configure your .env file with credentials
• Set up authentication methods (Magic Link, Google, Apple)
• Create database tables with Row Level Security
• Install the Supabase MCP for direct database management

Manual Setup

1. Create a Supabase Project

1. Go to supabase.com  and create an account
2. Click New Project
3. Enter a project name and database password
4. Wait for the project to be created (takes ~2 minutes)

2. Get Your Credentials

1. Go to Settings → API
2. Copy the Project URL and anon public key

3. Configure Your App

Create a .env file in your project root:

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

Important: Use the anon key (safe for client-side), NOT the service_role key.

That’s it! Your app will now connect to Supabase automatically.

Next Steps

Configure the features you need:

• Authentication - User login with magic links & Google OAuth
• Email Setup - SMTP for sending magic link emails
• Database - Tables & Row Level Security
• Push Tokens - Store push notification tokens

Verify Setup

After adding your credentials, restart the app. You should see in the console:

✅ Supabase initialized successfully

If you see warnings about missing configuration, double-check your .env file and restart the development server.