SaaSStarter Mobile Template

A reusable Expo SDK 57 mobile SaaS starter with Supabase Auth, Supabase database foundations, RevenueCat subscriptions, push notifications, remote config, feature flags, onboarding, analytics scaffolding, theming, localization, and developer diagnostics.

This repository is intended to be copied into a new product and customized from central configuration files rather than by editing infrastructure code throughout the app.

Quick Start

npm install
cp .env.example .env
npx expo start --dev-client

Fill .env with the public mobile values from your own Supabase and RevenueCat projects. Do not commit .env.

Because this app uses native modules such as RevenueCat and Expo Notifications, use a development build. Expo Go is not the supported target for the full template.

Main Setup Guides

• Quick Start
• Create a New App
• Supabase Setup
• RevenueCat Setup
• Notifications Setup
• Known Issues

Configuration

Start with:

• src/config/app-config.ts for product name, legal URLs, support email, entitlement ID, usage limits, and feature flags.
• src/config/branding.ts for brand colors and display identity.
• .env.example for required public environment variable names.

Do not store service-role keys, RevenueCat secret REST API keys, webhook secrets, notification admin secrets, or other server secrets in the mobile app.

Supabase

The canonical database migration source is:

supabase/migrations

Apply migrations to a linked Supabase project with:

npx supabase link --project-ref <project-ref>
npx supabase db push

Deploy Edge Functions from this repository after linking the project. See the setup docs for each function and secret.

RevenueCat

RevenueCat remains the payment source of truth. Supabase public.subscriptions is a server-side mirror used by app queries, admin views, analytics, and limits.

Keep the entitlement configured in RevenueCat aligned with:

Saas Starter Template Pro

Template Notes

• Developer Health and diagnostics are kept for internal testing, but normal users must not see internal tooling.
• src/features/example-feature is a removable example module.
• RevenueCat Test Store behavior is development-only and uses accelerated renewals and expirations.
• Known Android dev-client navigation layout-shift behavior is documented in Known Issues.

Validation

npm run lint
npx tsc --noEmit

Run npx expo-doctor before release builds or dependency upgrades.