Persistence (UserDefaults)

Persistence (UserDefaults)

Persist small preferences and settings with UserDefaults, and share values to widgets using App Groups.

UserDefaults API

Store small preferences like flags or last-used values.

Syntax:

• UserDefaults.standard.set(_:forKey:)
• .bool(forKey:)
• SwiftUI @AppStorage("key")

import SwiftUI

struct UserDefaultsDemo: View {
  @AppStorage("username") private var username = ""
  var body: some View {
    VStack(spacing: 12) {
      Text(username.isEmpty ? "Hello, Guest" : "Hello, " + username)
      TextField("Username", text: $username)
        .textFieldStyle(.roundedBorder)
    }
    .padding()
  }
}

import SwiftUI

struct ContentView: View {
  var body: some View { UserDefaultsDemo() }
}

import SwiftUI

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

The UserDefaults API provides a simple way to store small preferences and settings, such as flags or last-used values.

App Group Shared Defaults (Widget Access)

Share small values between your app and a Widget (or extensions) using an App Group suite.

Syntax:

• UserDefaults(suiteName: "group.id")
• shared.set(_:forKey:)
• shared.integer(forKey:)

import SwiftUI
import Foundation

struct AppGroupDemo: View {
  private let suite = UserDefaults(suiteName: "group.com.example.notes")!
  @State private var count: Int = 0
  var body: some View {
    VStack(spacing: 12) {
      Text("Notes count: \(count)")
      HStack {
        Button("Increment") { count += 1; suite.set(count, forKey: "notesCount") }
        Button("Load") { count = suite.integer(forKey: "notesCount") }
        Button("Clear") { suite.removeObject(forKey: "notesCount"); count = 0 }
      }
    }
    .task { count = suite.integer(forKey: "notesCount") }
    .padding()
  }
}

import SwiftUI

struct ContentView: View {
  var body: some View { AppGroupDemo() }
}

import SwiftUI

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

Example: Share a notes count between the app and a widget.