ios-setup

name	ios-setup
description	Configure le workflow iOS/tvOS optimal : VS Code + Claude Code + Xcode minimal + Makefile. Génère la structure, le Makefile V4, les tasks VS Code, le CLAUDE.md projet. Déclenché automatiquement si Xcode ou Swift est mentionné.
figure	Maître d'atelier
triggers	xcode, ios, tvos, swift, swiftui, app store, testflight, simulateur

iOS Setup

L'atelier s'ouvre sur un nouveau chantier. Pas une app ordinaire — une app Apple. Les règles changent. Les outils aussi. Le Maître d'atelier sort le plan spécial.

Setup complet du workflow iOS/tvOS dans l'atelier.

Quand se déclencher

• Mention de Xcode, iOS, tvOS, Swift, SwiftUI, App Store, TestFlight
• Projet mobile en cours de setup
• /ios-setup explicite

Le principe

Xcode est incontournable chez Apple. Mais il ne doit pas être le centre.

80-95% du dev → VS Code + Claude Code
5-20% → Xcode (signing, device, LLDB, archive)

Le Makefile est le pont. make run remplace "ouvrir Xcode, sélectionner le scheme, cliquer Run".

Procédure

Étape 1 — Vérifier les pré-requis

xcodebuild -version   # Xcode 15+ recommandé
swift --version
gem install xcpretty
brew install jq

Si Xcode absent → "Télécharger Xcode depuis l'App Store avant de continuer. C'est le seul prérequis non négociable."

Étape 2 — Générer la structure projet

MyApp/
├── MyApp.xcodeproj
├── MyApp/
│   ├── App/          (MyAppApp.swift, ContentView.swift)
│   ├── Views/
│   ├── ViewModels/
│   ├── Models/
│   ├── Services/
│   ├── Components/
│   └── Resources/
├── MyAppTests/
├── Packages/CoreKit/
├── Scripts/
├── .vscode/          (tasks.json, settings.json)
├── Makefile
└── CLAUDE.md

Étape 3 — Demander les informations projet

Avant de générer le Makefile, récupérer :

1. Nom du projet (ex: MyApp)
2. Bundle ID iOS (ex: com.example.myapp)
3. Bundle ID tvOS si applicable
4. Scheme iOS (souvent = nom du projet)
5. Scheme tvOS si applicable
6. Simulateur cible iOS (défaut: iPhone 15 Pro)
7. Simulateur cible tvOS (défaut: Apple TV 4K (3rd generation))

Étape 4 — Générer le Makefile V4

Avec les infos récupérées, générer le Makefile complet incluant :

• make run → build + boot simulator + install + launch
• make tvrun → idem tvOS
• make test → tests unitaires
• make doctor → diagnostic setup
• make devices → liste devices
• make device DEVICE_ID=<udid> → device réel
• make archive → archive App Store
• make clean → nettoyage
• make logs → logs build
• make help → aide

Étape 5 — Générer les tasks VS Code

Fichier .vscode/tasks.json avec :

• ⌘⇧B → Run iOS Simulator
• Run tvOS Simulator
• Run Tests
• Doctor / Clean / List Devices

Étape 6 — Générer le CLAUDE.md projet iOS

## Projet iOS
- Nom : [nom]
- Plateformes : iOS 17+ / tvOS 17+
- Langage : Swift 5.9+
- UI : SwiftUI
- Architecture : MVVM + Services + local Swift Packages
- Scheme iOS : [scheme]  Bundle : [bundle_id]
- Simulateur : iPhone 15 Pro
- Règles : async/await, une Preview par View, logique → CoreKit
- Ne pas modifier : .xcodeproj interne, signing, Info.plist

Étape 7 — Générer le .gitignore iOS

# Xcode
*.xcuserstate
xcuserdata/
DerivedData/
*.xcscmblueprint

# Build
.build/

# macOS
.DS_Store

Étape 8 — Vérification finale

make doctor
make help

Si tout est vert → "L'atelier iOS est prêt. make run pour lancer."

Règles

• Jamais forcer l'ouverture de Xcode si une commande CLI suffit
• Toujours demander bundle ID avant de générer le Makefile (sans lui, simctl launch échoue)
• Si Swift Package Manager est utilisé : documenter les packages dans §0
• Tests SwiftUI : XCTest + .testable import
• §5 prime : ne pas inventer de flags xcodebuild non vérifiés

Prompts utiles à proposer après setup

# Refactor SwiftUI
Refactor this SwiftUI screen into smaller reusable components.
Keep previews. Preserve current behavior.

# MVVM
Reorganize this feature into MVVM.
Move side effects to Services, keep the View simple.

# Tests
Generate unit tests for this service. Cover success + failure cases.

# Performance
Review this SwiftUI view for unnecessary re-renders.