Skill v1.0.1

currentAutomated scan98/100

tddworks/claude-skills/ios-app-scaffold

3 files

──Details

PublishedJune 26, 2026 at 10:14 AM

Content Hashsha256:4655443ca4e72cbd...

Git SHA650e9654f655

Bump Typepatch

Compare with v1.0.0

──Files

Files (1 file, 4.7 KB)

SKILL.md4.7 KBactive

SKILL.md · 165 lines · 4.7 KB

version: "1.0.1" name: ios-app-scaffold description: | Scaffold iOS apps with Tuist and layered architecture (Domain, Infrastructure, App). Use when: (1) Creating a new iOS app project, (2) Setting up Tuist project structure, (3) User asks to "create an iOS app", "scaffold an app", or "set up a new Swift project", (4) User wants layered/clean architecture for iOS, (5) User mentions Tuist setup.

iOS App Scaffold

Scaffold iOS apps with Tuist, Swift 6, and layered architecture.

Quick Start

Run the scaffold script:

bash

python3 scripts/scaffold.py <AppName> <output-directory> [--bundle-id <id>] [--team-id <id>]

Example:

bash

python3 scripts/scaffold.py MyApp /Users/me/projects --bundle-id com.mycompany.myapp --team-id ABC123

Then generate and open:

bash

cd /Users/me/projects/MyApp
tuist generate
open MyApp.xcworkspace

Generated Structure

AppName/
├── Sources/
│   ├── App/                    # SwiftUI views, app entry
│   │   ├── Views/
│   │   ├── Resources/
│   │   │   ├── Assets.xcassets
│   │   │   ├── XCConfig/       # Build configuration
│   │   │   │   ├── shared.xcconfig
│   │   │   │   ├── debug.xcconfig
│   │   │   │   └── release.xcconfig
│   │   │   └── en.lproj/
│   │   ├── Application/
│   │   ├── Info.plist
│   │   └── AppNameApp.swift
│   ├── Domain/                 # Business logic (no dependencies)
│   │   ├── Models/
│   │   ├── Protocols/          # @Mockable repository interfaces
│   │   └── Utils/
│   └── Infrastructure/         # Persistence implementations
│       └── Local/              # SwiftData repositories
├── Tests/
│   ├── DomainTests/
│   └── InfrastructureTests/
├── Project.swift               # Tuist configuration
├── Tuist.swift
├── .gitignore
└── README.md

Architecture

Layer	Purpose	Dependencies
Domain	Models, protocols, business logic	None
Infrastructure	SwiftData persistence	Domain
App	SwiftUI views, app entry	Domain, Infrastructure

For detailed patterns, see references/architecture.md.

After Scaffolding

Replace example files: Edit Example.swift, ExampleRepository.swift, LocalExampleRepository.swift
Add domain models: Create models in Sources/Domain/Models/
Define protocols: Add repository protocols in Sources/Domain/Protocols/
Implement persistence: Add SwiftData entities in Sources/Infrastructure/Local/
Build UI: Create views in Sources/App/Views/

Adding Dependencies

Edit Project.swift packages array:

swift

packages: [
    .remote(url: "https://github.com/Kolos65/Mockable.git", requirement: .upToNextMajor(from: "0.5.0")),
    // Add more packages here
],

Then add to target dependencies:

swift

dependencies: [
    .package(product: "PackageName"),
]

Key Patterns

Domain models are rich - Include computed properties and business logic:

swift

public struct Order: Identifiable, Codable, Sendable {
    public var items: [Item]
    public var total: Decimal { items.reduce(0) { $0 + $1.price } }
}

Protocols use @Mockable - Enables testing without real persistence:

swift

@Mockable
public protocol OrderRepository: Sendable {
    func fetchAll() async throws -> [Order]
}

Views consume Domain directly - No ViewModel layer needed:

swift

struct OrdersView: View {
    let orders: [Order]  // Domain model directly
}

Version Management

Version numbers are managed in Project.swift build settings:

swift

settings: .settings(
    base: [
        "MARKETING_VERSION": "1.0.0",      // App Store version
        "CURRENT_PROJECT_VERSION": "1",     // Build number
    ],
    ...
)

The Info.plist references these via build setting variables:

CFBundleShortVersionString → $(MARKETING_VERSION)
CFBundleVersion → $(CURRENT_PROJECT_VERSION)

To bump version, edit Project.swift:

swift

"MARKETING_VERSION": "1.1.0",
"CURRENT_PROJECT_VERSION": "2",

XCConfig

Build settings are managed via xcconfig files in Sources/App/Resources/XCConfig/:

File	Purpose
`shared.xcconfig`	Common settings (bundle ID, team ID, deployment target)
`debug.xcconfig`	Debug configuration (Apple Development signing)
`release.xcconfig`	Release configuration (Apple Development signing)

Edit shared.xcconfig to customize:

PRODUCT_BUNDLE_IDENTIFIER = com.yourcompany.app
DEVELOPMENT_TEAM = YOUR_TEAM_ID
IPHONEOS_DEPLOYMENT_TARGET = 18.0

← v1.0.0 All versions