Xcode Project Setup and Tooling¶

Xcode is the required IDE for iOS development. This covers project creation, interface navigation, live previews, simulator usage, version control, and file organization conventions.

Key Facts¶

Download Xcode from developer.apple.com (free Apple ID required)
Xcode 15+ for iOS 17, Xcode 16+ for iOS 18 development
Simulator downloads separately (~7 GB); wait for it before running apps
SwiftUI Canvas provides real-time preview without running the simulator
One view per file is the convention; model files import Foundation, views import SwiftUI
Swift Playgrounds (File > New > Playground) provide a REPL-like sandbox
First launch: select platforms (iOS is required, uncheck Watch to save time)

Patterns¶

Creating a New Project¶

File > New > Project > iOS > App
Product name = app name
Interface: SwiftUI (not Storyboard/UIKit)
Language: Swift
Storage: None (basic), SwiftData (iOS 17+), or Core Data (legacy persistence)

Generated files: - AppName.swift - entry point with @main, WindowGroup { ContentView() } - ContentView.swift - first view with default "Hello, world!" text

Xcode Interface¶

Area	Location	Purpose
Navigator	Left sidebar	File tree, toggle with folder icon
Editor	Center	Code editing
Canvas/Preview	Right of editor	Live SwiftUI preview
Console	Bottom	Debug output from `print()`
Run button	Top-left toolbar	Build and launch in simulator

Themes: Xcode > Settings > Themes (Dusk, Classic Light/Dark, Midnight).

@main App Entry Point¶

@main
struct MyApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

Preview Macro¶

// Modern syntax (Xcode 15+)
#Preview {
    ContentView()
}

// Legacy syntax (still valid)
struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
    }
}

// Dark mode preview
#Preview {
    ContentView()
        .preferredColorScheme(.dark)
}

Preview with Data Dependencies¶

// SwiftData preview
#Preview {
    JournalEntriesListView()
        .modelContainer(for: JournalEntry.self, inMemory: true)
}

// Core Data preview
#Preview {
    PokemonDetail(pokemon: PersistenceController.preview.fetchPokemon(id: 1))
}

File Organization¶

MyApp/
  MyApp.swift              // @main entry point
  ContentView.swift        // root view
  Views/
    DetailView.swift       // additional views
    RowView.swift
  Models/
    DataModel.swift        // import Foundation only
    Enums.swift
  Assets.xcassets/         // images, colors, app icon

Model/enum files: import Foundation only (not SwiftUI)
View files: import SwiftUI
New SwiftUI view: File > New File from Template > SwiftUI View
Naming convention: CamelCase ending in View (e.g., CustomButtonView)

Import Frameworks¶

import SwiftUI        // UI framework
import Foundation     // strings, dates, URLs
import MapKit         // maps
import SwiftData      // persistence (iOS 17+)
import Charts         // data visualization
import AVKit          // audio/video
import StoreKit       // in-app purchases
import TipKit         // onboarding tips (iOS 17+)

Renaming Views Safely¶

Use Xcode refactor: double-click view name > Right-click > Refactor > Rename. Updates all references including file, preview, and app entry point.

Version Control in Xcode¶

Source Control > New Git Repositories
Option+Cmd+C opens commit dialog
Stage all > write message > Commit
Commit after each working feature for safe rollback points

Live Preview Tips¶

Canvas shows real-time updates without running simulator
Click play button in canvas to enable live interaction
If preview stops: Show Editor Only, then switch back to Canvas
Nuclear option for stuck previews: quit and reopen Xcode

Gotchas¶

First Xcode launch requires platform selection - iOS is required, uncheck Watch to save download time
inMemory: true in previews means data is not persisted - use the simulator to test actual persistence
Canvas preview does not support all features (e.g., AsyncImage requires live preview or simulator)
Adding a framework import that is not needed can cause build errors in some configurations
The .storekit configuration file must be selected in scheme settings for IAP testing
Storage option during setup: choose None if you don't need persistence yet - SwiftData/Core Data can be added later