<!--
{
  "availability" : [
    "watchOS: 10.2.0 -",
    "Xcode: 15.1.0 -",
    "macOS: 14.2.0 -",
    "iOS: 17.2.0 -"
  ],
  "documentType" : "article",
  "framework" : "SwiftUI",
  "identifier" : "/documentation/SwiftUI/Backyard-birds-sample",
  "metadataVersion" : "0.1.0",
  "role" : "sampleCode",
  "title" : "Backyard Birds: Building an app with SwiftData and widgets"
}
-->

# Backyard Birds: Building an app with SwiftData and widgets

Create an app with persistent data, interactive widgets, and an all new in-app purchase experience.

## Overview

Backyard Birds offers a rich environment in which you can watch the birds that visit your backyard garden.
You can monitor their water and food supply to ensure they always have fresh water and plenty to eat,
or upgrade the game using an in-app purchase to provide tastier food for the birds to eat.

The sample implements its data model using [SwiftData](doc://com.apple.documentation/documentation/SwiftData)
for persistence, and integrates seamlessly with SwiftUI using the [`Observable`](doc://com.apple.documentation/documentation/Observation) protocol.
The game’s widgets implement [App Intents](doc://com.apple.documentation/documentation/AppIntents) for interactive and configurable widgets. The in-app purchase experience uses the [`ProductView`](doc://com.apple.documentation/documentation/StoreKit/ProductView)
and [`SubscriptionStoreView`](doc://com.apple.documentation/documentation/StoreKit/SubscriptionStoreView) from StoreKit.

You can access the source code for this sample
on [GitHub](https://github.com/apple/sample-backyard-birds).

> Note: This sample code project is associated with WWDC23 session 102:
> [State of the Union](https://developer.apple.com/wwdc23/102/).

### Configure the sample code project

To configure the Backyard Birds app to run on your devices, follow these steps:

1. Open the project in Xcode 15 or later.
1. Edit the multiplatform target’s scheme, and on the Options tab, choose the `Store.storekit` file for StoreKit configuration.
1. Repeat the previous step for the watchOS target’s scheme.
1. Select the top-level Backyard Birds project.
1. For all targets, choose your team from the Team menu in the Signing & Capabilities pane so Xcode can automatically manage your provisioning profile.

### Create a data-driven app

The app defines its data model by conforming the model objects to [`PersistentModel`](doc://com.apple.documentation/documentation/SwiftData/PersistentModel)
using the [`Model`](doc://com.apple.documentation/documentation/SwiftData/Model()) macro.
Using the [`Attribute`](doc://com.apple.documentation/documentation/SwiftData/Attribute(_:originalName:hashModifier:)) macro
with the [`unique`](doc://com.apple.documentation/documentation/SwiftData/Schema/Attribute/Option/unique)
option ensures that the `id` property is unique.

```swift
@Model public class BirdSpecies {
    @Attribute(.unique) public var id: String
    public var naturalScale: Double
    public var isEarlyAccess: Bool
    public var parts: [BirdPart]
    
    @Relationship(deleteRule: .cascade, inverse: \Bird.species)
    public var birds: [Bird] = []
    
    public var info: BirdSpeciesInfo { BirdSpeciesInfo(rawValue: id) }
    
    public init(info: BirdSpeciesInfo, naturalScale: Double = 1, isEarlyAccess: Bool = false, parts: [BirdPart]) {
        self.id = info.rawValue
        self.naturalScale = naturalScale
        self.isEarlyAccess = isEarlyAccess
        self.parts = parts
    }
}
```

### Construct interactive widgets

Backyard Birds displays interactive widgets by presenting a [`Button`](/documentation/SwiftUI/Button) to refill a backyard’s supplies
when the water and food are running low. The app does this by placing a `Button` in the widget’s view,
and passing a `ResupplyBackyardIntent` instance to the
[`init(intent:label:)`](doc://com.apple.documentation/documentation/SwiftUI/Button/init(intent:label:)) initializer:

```swift
Button(intent: ResupplyBackyardIntent(backyard: BackyardEntity(from: snapshot.backyard))) {
    Label("Refill Water", systemImage: "arrow.clockwise")
        .foregroundStyle(.secondary)
        .frame(maxWidth: .infinity)
        .padding(.vertical, 8)
        .padding(.horizontal, 12)
        .background(.quaternary, in: .containerRelative)
}
```

The app allows for configuration of the widget by implementing the
[`WidgetConfigurationIntent`](doc://com.apple.documentation/documentation/AppIntents/WidgetConfigurationIntent)
protocol:

```swift
struct BackyardWidgetIntent: WidgetConfigurationIntent {
    static let title: LocalizedStringResource = "Backyard"
    static let description = IntentDescription("Keep track of your backyards.")
    
    @Parameter(title: "Backyards", default: BackyardWidgetContent.all)
    var backyards: BackyardWidgetContent
    
    @Parameter(title: "Backyard")
    var specificBackyard: BackyardEntity?
    
    init(backyards: BackyardWidgetContent = .all, specificBackyard: BackyardEntity? = nil) {
        self.backyards = backyards
        self.specificBackyard = specificBackyard
    }
    
    init() {
    }
    
    static var parameterSummary: some ParameterSummary {
        When(\.$backyards, .equalTo, BackyardWidgetContent.specific) {
            Summary {
                \.$backyards
                \.$specificBackyard
            }
        } otherwise: {
            Summary {
                \.$backyards
            }
        }
    }
}
```

### Provide a new in-app purchase experience

The sample app uses [`ProductView`](doc://com.apple.documentation/documentation/StoreKit/ProductView) to display several different bird food upgrades available for purchase on a store shelf.
To prominently feature an in-app purchase item, the app uses the
[`.productViewStyle(.large)`](doc://com.apple.documentation/documentation/SwiftUI/View/productViewStyle(_:)) modifier:

```swift
ProductView(id: product.id) {
    BirdFoodProductIcon(birdFood: birdFood, quantity: product.quantity)
        .bestBirdFoodValueBadge()
}
.padding(.vertical)
.background(.background.secondary, in: .rect(cornerRadius: 20))
.productViewStyle(.large)
```

The Backyard Birds Pass page displays renewable subscriptions using the
[`SubscriptionStoreView`](doc://com.apple.documentation/documentation/StoreKit/SubscriptionStoreView) view.
The app uses the `PassMarketingContent` view as the content of the `SubscriptionStoreView`:

```swift
SubscriptionStoreView(
    groupID: passGroupID,
    visibleRelationships: showPremiumUpgrade ? .upgrade : .all
) {
    PassMarketingContent(showPremiumUpgrade: showPremiumUpgrade)
        #if !os(watchOS)
        .containerBackground(for: .subscriptionStoreFullHeight) {
            SkyBackground()
        }
        #endif
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)