diff --git a/docs/cookbook/quickstart.md b/docs/cookbook/quickstart.md
index 789f092..7e31534 100644
--- a/docs/cookbook/quickstart.md
+++ b/docs/cookbook/quickstart.md
@@ -2,6 +2,8 @@
 
 This page provides an overview of how BDK can be leveraged to create and sync a wallet using an Esplora client. You can find [working code examples](https://github.com/bitcoindevkit/book-of-bdk/tree/master/examples) of this workflow in three programming languages: [Rust](https://github.com/bitcoindevkit/book-of-bdk/tree/master/examples/rust), [Swift](https://github.com/bitcoindevkit/book-of-bdk/tree/master/examples/swift), and [Kotlin](https://github.com/bitcoindevkit/book-of-bdk/tree/master/examples/kotlin).
 
+Note that these examples are meant to be run at the command line. If you're building a mobile app in an IDE like xcode or androidstudio the process (of project creation, dependency selection and running the code) may be different.
+
 !!! tip
     This page is up-to-date with version `1.0.0-beta.5` of `bdk_wallet`.
 
@@ -16,7 +18,10 @@ This page provides an overview of how BDK can be leveraged to create and sync a
 
 === "Swift"
 
-    Create a new Swift project in Xcode.
+    ```shell
+    swift package init --type executable
+    ```
+    Or, if you're building an iOS app, create a new Swift project in Xcode.
 
 === "Kotlin"
 
@@ -32,8 +37,14 @@ This page provides an overview of how BDK can be leveraged to create and sync a
 
 === "Swift"
 
+    ```toml title="Package.swift"
+    --8<-- "examples/swift/quickstart/Package.swift"
+    ```
+    Or, if you're building an iOS app:
+    
     1. From the Xcode File menu, select Add Package Dependencies...
-    2. Enter `https://github.com/bitcoindevkit/bdk-swift` into the package repository URL text field
+    2. Enter `https://github.com/bitcoindevkit/bdk-swift` into the package repository URL search field and bdk-swift should come up
+    3. For the Dependency Rule select `Exact Version`, enter the version number (same as Package.swift) and click Add Package
 
 === "Kotlin"
 
@@ -52,8 +63,8 @@ We'll give a breakdown of the key pieces of this code in the next section.
 
 === "Swift"
 
-    ```swift title="examples/swift/quickstart/main.swift"
-    --8<-- "examples/swift/quickstart/main.swift:file"
+    ```swift title="examples/swift/quickstart/Sources/main.swift"
+    --8<-- "examples/swift/quickstart/Sources/main.swift:file"
     ```
 
 === "Kotlin"
@@ -75,7 +86,10 @@ The wallet will take a few seconds to sync, then you should see the wallet balan
 
 === "Swift"
 
-    Run the project in Xcode.
+    ```shell
+    swift run
+    ```
+    Or run the project in Xcode.
 
 === "Kotlin"
 
@@ -96,7 +110,7 @@ First we need some <a href="https://github.com/bitcoin/bitcoin/blob/master/doc/d
 === "Swift"
 
     ```swift
-    --8<-- "examples/swift/quickstart/main.swift:descriptors"
+    --8<-- "examples/swift/quickstart/Sources/main.swift:descriptors"
     ```
 
 === "Kotlin"
@@ -119,7 +133,7 @@ This example is using an <a href="https://github.com/Blockstream/esplora" target
 === "Swift"
 
     ```swift
-    --8<-- "examples/swift/quickstart/main.swift:client"
+    --8<-- "examples/swift/quickstart/Sources/main.swift:client"
     ```
 
 === "Kotlin"
@@ -145,7 +159,7 @@ Once we have our wallet setup and connected to the network, we scan the network
 === "Swift"
 
     ```swift
-    --8<-- "examples/swift/quickstart/main.swift:scan"
+    --8<-- "examples/swift/quickstart/Sources/main.swift:scan"
     ```
 
 === "Kotlin"
diff --git a/examples/swift/quickstart/.gitignore b/examples/swift/quickstart/.gitignore
new file mode 100644
index 0000000..0023a53
--- /dev/null
+++ b/examples/swift/quickstart/.gitignore
@@ -0,0 +1,8 @@
+.DS_Store
+/.build
+/Packages
+xcuserdata/
+DerivedData/
+.swiftpm/configuration/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc
diff --git a/examples/swift/quickstart/Package.resolved b/examples/swift/quickstart/Package.resolved
new file mode 100644
index 0000000..e68ac4d
--- /dev/null
+++ b/examples/swift/quickstart/Package.resolved
@@ -0,0 +1,15 @@
+{
+  "originHash" : "80a7f511dc9201d59f1672d17a6a92dca3d40856c08e16f03e8087f59734809a",
+  "pins" : [
+    {
+      "identity" : "bdk-swift",
+      "kind" : "remoteSourceControl",
+      "location" : "https://github.com/bitcoindevkit/bdk-swift",
+      "state" : {
+        "revision" : "875877e5c5eb753df2673958ee2f54a5360581f7",
+        "version" : "1.0.0-beta.5"
+      }
+    }
+  ],
+  "version" : 3
+}
diff --git a/examples/swift/quickstart/Package.swift b/examples/swift/quickstart/Package.swift
new file mode 100644
index 0000000..e152049
--- /dev/null
+++ b/examples/swift/quickstart/Package.swift
@@ -0,0 +1,22 @@
+// swift-tools-version: 5.10
+
+import PackageDescription
+
+let package = Package(
+    name: "QuickstartExample",
+    platforms: [
+        .macOS(.v12)
+    ],
+    dependencies: [
+        .package(url: "https://github.com/bitcoindevkit/bdk-swift", from: "1.0.0-beta.5")
+    ],
+    targets: [
+        .executableTarget(
+            name: "QuickstartExample",
+            dependencies: [
+                .product(name: "BitcoinDevKit", package: "bdk-swift")
+            ],
+            path: "Sources"
+        )
+    ]
+)
\ No newline at end of file
diff --git a/examples/swift/quickstart/Sources/main.swift b/examples/swift/quickstart/Sources/main.swift
new file mode 100644
index 0000000..a935169
--- /dev/null
+++ b/examples/swift/quickstart/Sources/main.swift
@@ -0,0 +1,34 @@
+// --8<-- [start:file]
+import BitcoinDevKit
+
+// --8<-- [start:descriptors]
+let descriptor = try Descriptor(descriptor: "tr([12071a7c/86'/1'/0']tpubDCaLkqfh67Qr7ZuRrUNrCYQ54sMjHfsJ4yQSGb3aBr1yqt3yXpamRBUwnGSnyNnxQYu7rqeBiPfw3mjBcFNX4ky2vhjj9bDrGstkfUbLB9T/0/*)#z3x5097m", network: Network.signet)
+let changeDescriptor = try Descriptor(descriptor: "tr([12071a7c/86'/1'/0']tpubDCaLkqfh67Qr7ZuRrUNrCYQ54sMjHfsJ4yQSGb3aBr1yqt3yXpamRBUwnGSnyNnxQYu7rqeBiPfw3mjBcFNX4ky2vhjj9bDrGstkfUbLB9T/1/*)#n9r4jswr", network: Network.signet)
+// --8<-- [end:descriptors]
+
+let wallet = try Wallet(
+    descriptor: descriptor,
+    changeDescriptor: changeDescriptor,
+    network: Network.signet,
+    connection: Connection.newInMemory()
+)
+
+let addressInfo = wallet.revealNextAddress(keychain: .external)
+print("Generated address \(addressInfo.address) at index \(addressInfo.index)")
+
+// --8<-- [start:client]
+let esploraClient = EsploraClient(url: "https://mutinynet.com/api")
+// --8<-- [end:client]
+
+// --8<-- [start:scan]
+let syncRequest = try wallet.startSyncWithRevealedSpks().build()
+let update = try esploraClient.sync(
+    syncRequest: syncRequest,
+    parallelRequests: UInt64(5)
+)
+try wallet.applyUpdate(update: update)
+let balance = wallet.balance()
+print("Wallet balance: \(balance.total.toSat()) sat")
+// --8<-- [end:scan]
+
+// --8<-- [end:file]
diff --git a/examples/swift/quickstart/main.swift b/examples/swift/quickstart/main.swift
deleted file mode 100644
index 81eb373..0000000
--- a/examples/swift/quickstart/main.swift
+++ /dev/null
@@ -1,34 +0,0 @@
-// --8<-- [start:file]
-
-// --8<-- [start:descriptors]
-let descriptor = "tr([12071a7c/86'/1'/0']tpubDCaLkqfh67Qr7ZuRrUNrCYQ54sMjHfsJ4yQSGb3aBr1yqt3yXpamRBUwnGSnyNnxQYu7rqeBiPfw3mjBcFNX4ky2vhjj9bDrGstkfUbLB9T/0/*)#z3x5097m"
-let changeDescriptor = "tr([12071a7c/86'/1'/0']tpubDCaLkqfh67Qr7ZuRrUNrCYQ54sMjHfsJ4yQSGb3aBr1yqt3yXpamRBUwnGSnyNnxQYu7rqeBiPfw3mjBcFNX4ky2vhjj9bDrGstkfUbLB9T/1/*)#n9r4jswr"
-// --8<-- [end:descriptors]
-
-let wallet = try Wallet(
-    descriptor: descriptor, 
-    changeDescriptor: changeDescriptor, 
-    network: Network.signet
-)
-
-// --8<-- [start:address]
-let addressInfo = wallet.revealNextAddress(keychain: .external)
-print("Generated address \(addressInfo.address) at index \(addressInfo.index)")
-// --8<-- [end:address]
-
-// --8<-- [start:client]  
-let esploraClient = EsploraClient(url: "https://mutinynet.com/api")
-// --8<-- [end:client]
-
-// --8<-- [start:scan]
-let syncRequest = wallet.startSyncWithRevealedSpks()
-let update = try esploraClient.sync(
-    syncRequest: syncRequest,
-    parallelRequests: UInt64(5)
-)
-try wallet.applyUpdate(update: update)
-let balance = wallet.balance()
-print("Wallet balance: \(balance.total) sat")
-// --8<-- [end:scan]
-
-// --8<-- [end:file]
\ No newline at end of file