ios-local-staging-setup

What problem does it solve?

It solves the problem of slow, fragile local iOS development that can only use mocked data instead of production-like behavior, by wiring an iOS simulator to a local Supabase instance loaded with a scoped snapshot of real production data.

Core Features & Use Cases

• One-time local staging infrastructure: Initializes Supabase locally, sets up env switching, and configures simulator-only behavior so builds continue targeting production automatically.
• Compile-time URL switching for simulator: Detects DEBUG + simulator at compile time to route API calls to localhost without manual scheme/xcconfig changes.
• Staging auth and graceful fallback: Adds a simulator launch argument flow (--skip-auth) to sign in against local staging users when available, with PreviewData fallback when Supabase is down.
• Production-to-local snapshot pipeline: Provides a scripted approach to export a single owner’s scoped production data and import it into local Supabase with matching auth identities and FK-safe ordering.

Quick Start

Run this skill to add local staging infrastructure so your iOS simulator automatically uses a local Supabase snapshot with real production data while device/TestFlight builds keep hitting production.