SwiftData setup (modern persistence) in iOS Swift

Introduction

SwiftData helps your app save and load data easily. It keeps your information safe even when the app closes.

You want to save user notes or settings on the device.

You need to keep a list of favorite items that the user can access later.

Your app should remember user progress or scores between sessions.

You want to store simple data without using complex databases.

Syntax

iOS Swift

import SwiftData

@Model
class Item {
  var name: String
  init(name: String) {
    self.name = name
  }
}

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        .modelContainer(for: [Item.self])
    }
  }
}

The @Model attribute marks a class as data you want to save.

The .modelContainer(for:) modifier sets up storage for your data models.

Examples

This defines a simple Task model with a title and a done status.

iOS Swift

import SwiftData

@Model
class Task {
  var title: String
  var done: Bool = false
  init(title: String) {
    self.title = title
  }
}

This sets up the app to use the Task model for data storage.

iOS Swift

import SwiftUI
import SwiftData

@main
struct MyApp: App {
  var body: some Scene {
    WindowGroup {
      TaskListView()
        .modelContainer(for: [Task.self])
    }
  }
}

Sample App

This app lets you add notes and saves them using SwiftData. Notes stay saved even if you close the app.

iOS Swift

import SwiftUI
import SwiftData

@Model
class Note {
  var content: String
  init(content: String) {
    self.content = content
  }
}

struct ContentView: View {
  @Environment(\.modelContext) private var context
  @Query private var notes: [Note]
  @State private var newNote = ""

  var body: some View {
    VStack {
      TextField("Enter note", text: $newNote)
        .textFieldStyle(.roundedBorder)
        .padding()
      Button("Add Note") {
        let note = Note(content: newNote)
        context.insert(note)
        try? context.save()
        newNote = ""
      }
      List(notes, id: \.self) { note in
        Text(note.content)
      }
    }
    .padding()
  }
}

@main
struct NotesApp: App {
  var body: some Scene {
    WindowGroup {
      ContentView()
        .modelContainer(for: [Note.self])
    }
  }
}

Important Notes

Always call try? context.save() after inserting or changing data to keep it saved.

Use @Query to automatically get updated data from your storage.

SwiftData works well with SwiftUI and updates your UI when data changes.

Summary

SwiftData makes saving app data easy and safe.

Mark your data classes with @Model and set up storage with .modelContainer(for:).

Use @Environment(\.modelContext) and @Query to work with your saved data in views.

Practice

1. What is the purpose of marking a class with @Model in SwiftData?

easy

A. It disables saving data for that class.

B. It makes the class visible only to the current view.

C. It tells SwiftData to manage and save instances of that class automatically.

D. It converts the class into a SwiftUI view.

Solution

1. Step 1: Understand the role of @Model

   The @Model attribute marks a class as a data model for SwiftData to manage persistence.

2. Step 2: Recognize automatic data management

   SwiftData automatically saves and tracks changes for classes marked with @Model.

3. Final Answer:

   It tells SwiftData to manage and save instances of that class automatically. -> Option C

4. Quick Check:

   @Model means automatic data management [OK]

Hint: Remember: @Model means SwiftData saves your data class [OK]

Common Mistakes:

• Thinking @Model creates a UI component
• Assuming @Model disables saving
• Confusing @Model with view modifiers

2. Which of the following is the correct way to set up a SwiftData model container in your app's main entry point?

easy

A. let container = ModelContainer(for: MyModel.self)

B. let container = .modelContainer(for: MyModel.self)

C. let container = ModelContainer(for: [MyModel].self)

D. let container = .modelContainer(for: [MyModel].self)

Solution

1. Step 1: Recall the correct syntax for model container setup

   SwiftData uses ModelContainer(for: MyModel.self) to create a container for a single model type.

2. Step 2: Identify the correct option

   let container = ModelContainer(for: MyModel.self) uses the correct constructor syntax.

3. Final Answer:

   let container = ModelContainer(for: MyModel.self) -> Option A

4. Quick Check:

   Model container setup uses ModelContainer(for: Type.self) [OK]

Hint: ModelContainer(for: MyModel.self) [OK]

Common Mistakes:

• Using [MyModel].self array syntax incorrectly
• Using .modelContainer() which is a view modifier
• Forgetting .self after the type

3. Given this SwiftUI view using SwiftData:

struct ContentView: View {
  @Environment(\.modelContext) private var context
  @Query var items: [Item]

  var body: some View {
    List(items) { item in
      Text(item.name)
    }
  }
}

What will happen if you add a new Item to context?

medium

A. The new item will be saved but not displayed in the list.

B. The list will not update until the app restarts.

C. The app will crash because @Query cannot detect changes.

D. The list will automatically update to show the new item.

Solution

1. Step 1: Understand @Query and @Environment(\.modelContext)

   @Query fetches data from the model container and updates the view automatically when data changes.

2. Step 2: Recognize automatic UI updates

   Adding a new Item to context triggers the @Query to refresh, updating the list.

3. Final Answer:

   The list will automatically update to show the new item. -> Option D

4. Quick Check:

   @Query updates UI on data change [OK]

Hint: @Query auto-refreshes UI when data changes [OK]

Common Mistakes:

• Thinking UI updates only on app restart
• Believing @Query is static data
• Assuming app crashes on data change

4. You wrote this code but your app crashes at runtime:

@Model
class Task {
  var title: String
  init(title: String) {
    self.title = title
  }
}

What is the likely cause of the crash?

medium

A. The class is missing a default initializer for SwiftData.

B. You must mark the class as final when using @Model.

C. The property title must be optional.

D. You cannot use classes with @Model, only structs.

Solution

1. Step 1: Check SwiftData model requirements

   SwiftData requires model classes to have a default initializer or all properties to have default values.

2. Step 2: Identify missing default initializer

   The class has a custom initializer but no default one, causing runtime issues.

3. Final Answer:

   The class is missing a default initializer for SwiftData. -> Option A

4. Quick Check:

   SwiftData models need default initializers [OK]

Hint: Ensure @Model classes have default initializers [OK]

Common Mistakes:

• Thinking @Model requires final keyword
• Making properties optional unnecessarily
• Believing only structs can be @Model

5. You want to create a SwiftData model for a Book with a title and optional author. You also want to fetch all books with a non-empty author in a SwiftUI view. Which code snippet correctly defines the model and query?

hard

A. @Model
class Book {
var title: String
var author: String
init() { title = ""; author = "" }
}
@Query(filter: #Predicate { $0.author != "" }) var books: [Book]

B. @Model
class Book {
var title: String = ""
var author: String? = nil
}
@Query(filter: #Predicate { $0.author != nil && !$0.author!.isEmpty }) var books: [Book]

C. @Model
class Book {
var title: String
var author: String?
}
@Query(filter: #Predicate { $0.author != nil }) var books: [Book]

D. @Model
class Book {
var title: String = ""
var author: String = ""
}
@Query(filter: #Predicate { $0.author.isEmpty }) var books: [Book]

Solution

1. Step 1: Define model with optional author and default values

   @Model
   class Book {
     var title: String = ""
     var author: String? = nil
   }

   @Query(filter: #Predicate { $0.author != nil && !$0.author!.isEmpty }) var books: [Book]

   correctly defines author as optional with a default nil and title with a default empty string.

2. Step 2: Use a filter predicate to fetch books with non-empty author

   The filter checks author != nil and that author is not empty, matching the requirement.

3. Final Answer:

   Correctly defines the model and query for non-empty authors. -> Option B

4. Quick Check:

   Optional author + filter for non-empty =

   @Model
   class Book {
     var title: String = ""
     var author: String? = nil
   }

   @Query(filter: #Predicate { $0.author != nil && !$0.author!.isEmpty }) var books: [Book]

   [OK]

Hint: Use optional property and filter for non-empty string [OK]

Common Mistakes:

• Forgetting to make author optional
• Using empty string author without optional
• Incorrect filter logic for non-empty strings