| name | ios-scaffold |
| description | Scaffold a SwiftUI iOS app (iPhone + iPad) with offline-first persistence, push notifications plumbing, SwiftFormat + SwiftLint, CI, and optional GitHub repo creation. |
| argument-hint | [app-name] [--github] [--public] [--org <org>] [--repo <n>] [--no-push] |
| allowed-tools | Bash, Write, Read, Glob, Grep |
Purpose
Create a fully working iOS repo with SwiftUI + MVVM, offline-first persistence, push notification plumbing (compiles without APNs), environment configs, tooling, and CI.
Arguments
app-name โ Project folder/app name (default: "App")
--github โ Create GitHub repo and push (requires gh auth)
--public โ Make GitHub repo public (default: private)
--org <n> โ Create under org instead of personal account
--repo <n> โ Override repo name (default: app-name)
--no-push โ Create repo and commit but don't push
Template-first rule
Copy files from templates/ into the project, preserving folder structure. Generate content for empty placeholder files following ios-std conventions.
Existing directory handling: If the target directory already exists (e.g., running in the current directory), scaffold files directly into it instead of creating a subdirectory. Check for flag to determine the repo name separately from the directory.