skills.rest
ElvinOuyang
ElvinOuyangCOMMUNITY
Explore all skills by this author →
GitHub

ios-local-staging-run

Run an iOS app on a simulator against a local Supabase staging environment.

Updated Aug 27, 2026
Search Tags:#supabase#staging#docker#ios#xcodebuild#data snapshot#simulator testing
One-click install
npx skills add https://github.com/ElvinOuyang/claude-skill-collection --skill ios-local-staging-run
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ios-local-staging-run
Source: https://github.com/ElvinOuyang/claude-skill-collection/tree/main/plugins/ios-dev-toolkit/skills/ios-local-staging-run
Command: npx skills add https://github.com/ElvinOuyang/claude-skill-collection --skill ios-local-staging-run

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of running your iOS app locally against a realistic iOS + Supabase staging stack by automating the full startup sequence and troubleshooting common local Docker/Supabase issues.

Core Features & Use Cases

  • One-command local staging workflow: Starts Docker, boots local Supabase, refreshes production snapshots, and launches the iOS app on a simulator with real data.
  • Fresh-data control: Re-snapshots production data when needed, including after wiped Docker volumes, so you can reliably reproduce bugs and validate features.
  • Simulator launch correctness: Looks up the built app’s real bundle identifier from Info.plist and launches with the required skip-auth flow.
  • Verification via accessibility tooling: Uses AXe to confirm that real staging data loaded (not preview/empty placeholders) by checking UI accessibility labels.

Quick Start

In your terminal, run the skill to start Docker and Supabase locally, snapshot production data into the local database, start the staging dev server, then build and launch the iOS app on the simulator with real data.

Frequently Asked Questions about ios-local-staging-run

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run my iOS app against a local Supabase staging environment with production data?▼

You can run your iOS app against local Supabase staging by automating Docker startup, booting Supabase, refreshing production snapshots, and launching the app on a simulator with real data.

What is the best way to test iOS simulator flows with real Supabase data snapshots?▼

Testing iOS simulator flows with real data involves snapshotting production Supabase data into a local database and verifying the loaded staging data via UI accessibility labels using AXe.

Why does my local Supabase staging server fail to start when running iOS simulator tests?▼

Local Supabase staging failures during iOS tests often stem from Docker daemon unreadiness or Supabase health issues, which require automated coordination and recovery before app launch.

Can I re-snapshot production data for iOS simulator testing after wiping Docker volumes?▼

Yes, you can re-snapshot production data into the local Supabase database even after wiping Docker volumes, ensuring you can reliably reproduce bugs and validate features with fresh data.

How does the iOS simulator launch correctly with local Supabase staging data?▼

Correct simulator launch with local Supabase staging data requires looking up the built app’s bundle identifier from Info.plist and executing the launch with the required skip-auth flow.

Do I need Docker to run an iOS app against a local Supabase staging stack?▼

Yes, Docker is required to boot the local Supabase environment and manage the production data snapshots needed for validating real end-to-end data flows in your iOS app.

Related Skills

Explore More Software Engineering Skills→
saskinosiesaskinosie
39

weaviate-connection

Connect to a local Weaviate instance and verify its health via Docker.

Community
Intermediate
AgentiveCityAgentiveCity
2

supabase-nextjs-integration

Set up Supabase integration in Next.js App Router projects with TypeScript.

Official
Advanced
BigdropsBigdrops
1

capacitor-ci-cd

Automate Capacitor app builds, tests, and deployments via GitHub Actions and GitLab CI.

Community
Advanced
zeronx798zeronx798

docker-management

Manage Docker container lifecycles, image builds, and infrastructure cleanup.

Community
Intermediate