From 7fbff450a4d05e4ad70b315e155d7e25f3e1d030 Mon Sep 17 00:00:00 2001
From: Kieran Klukas <me@dunkirk.sh>
Date: Fri, 27 Mar 2026 21:32:05 -0700
Subject: [PATCH] feat: add onboarding dialog

---
 overpass/Services/StoreManager.swift        | 10 ++-
 overpass/Views/ConfettiView.swift           | 72 +++++++++++++++++
 overpass/Views/OnboardingView.swift         | 89 +++++++++++++++++++++
 overpass/Views/SettingsView.swift           |  9 ++-
 overpass/overpass.xcodeproj/project.pbxproj |  8 ++
 overpass/overpassApp.swift                  | 16 +++-
 6 files changed, 201 insertions(+), 3 deletions(-)
 create mode 100644 overpass/Views/ConfettiView.swift
 create mode 100644 overpass/Views/OnboardingView.swift

diff --git a/overpass/Services/StoreManager.swift b/overpass/Services/StoreManager.swift
index 1f68480..3f6d991 100644
--- a/overpass/Services/StoreManager.swift
+++ b/overpass/Services/StoreManager.swift
@@ -8,13 +8,15 @@ final class StoreManager {
     static let shared = StoreManager()
 
     private(set) var isUnlocked = false
+    private(set) var justPurchased = false
+    var isAppActive = false
     private(set) var purchaseDate: Date?
     private(set) var product: Product?
     private(set) var isPurchasing = false
 
     private let productId = "sh.dunkirk.overpass.unlock"
     private let firstLaunchKeychainKey = "sh.dunkirk.overpass.first_launch"
-    static let trialDuration: TimeInterval = 7 * 24 * 60 * 60
+    static let trialDuration: TimeInterval = 15 * 24 * 60 * 60
 
     var trialStartDate: Date? {
         guard let stored = KeychainService.load(forKey: firstLaunchKeychainKey),
@@ -59,6 +61,10 @@ final class StoreManager {
                 } else {
                     isUnlocked = true
                     purchaseDate = tx.purchaseDate
+                    if isAppActive {
+                        justPurchased = true
+                        Task { try? await Task.sleep(for: .seconds(4)); justPurchased = false }
+                    }
                 }
                 await tx.finish()
             }
@@ -88,6 +94,8 @@ final class StoreManager {
         if case .success(let verification) = result,
            case .verified(_) = verification {
             isUnlocked = true
+            justPurchased = true
+            Task { try? await Task.sleep(for: .seconds(4)); justPurchased = false }
         }
     }
 
diff --git a/overpass/Views/ConfettiView.swift b/overpass/Views/ConfettiView.swift
new file mode 100644
index 0000000..ab0b2fc
--- /dev/null
+++ b/overpass/Views/ConfettiView.swift
@@ -0,0 +1,72 @@
+import SwiftUI
+
+struct ConfettiView: View {
+    struct Particle: Identifiable {
+        let id = UUID()
+        let x: CGFloat
+        let color: Color
+        let width: CGFloat
+        let height: CGFloat
+        let delay: Double
+        let duration: Double
+        let targetRotation: Double
+        let drift: CGFloat
+    }
+
+    private static let colors: [Color] = [.red, .orange, .yellow, .green, .blue, .purple, .pink, .cyan]
+
+    private let particles: [Particle] = (0..<90).map { _ in
+        Particle(
+            x: CGFloat.random(in: 0...1),
+            color: colors[Int.random(in: 0..<colors.count)],
+            width: CGFloat.random(in: 6...12),
+            height: CGFloat.random(in: 8...16),
+            delay: Double.random(in: 0...1.8),
+            duration: Double.random(in: 2...3.5),
+            targetRotation: Double.random(in: 180...540),
+            drift: CGFloat.random(in: -60...60)
+        )
+    }
+
+    var body: some View {
+        GeometryReader { geo in
+            ForEach(particles) { p in
+                ParticleView(particle: p, screenSize: geo.size)
+            }
+        }
+        .ignoresSafeArea()
+        .allowsHitTesting(false)
+    }
+}
+
+private struct ParticleView: View {
+    let particle: ConfettiView.Particle
+    let screenSize: CGSize
+
+    @State private var offsetY: CGFloat = 0
+    @State private var offsetX: CGFloat = 0
+    @State private var rotation: Double = 0
+    @State private var opacity: Double = 0
+
+    var body: some View {
+        Rectangle()
+            .fill(particle.color)
+            .frame(width: particle.width, height: particle.height)
+            .rotationEffect(.degrees(rotation))
+            .opacity(opacity)
+            .position(x: particle.x * screenSize.width + offsetX, y: -20 + offsetY)
+            .onAppear {
+                withAnimation(.easeIn(duration: 0.15).delay(particle.delay)) {
+                    opacity = 1
+                }
+                withAnimation(.linear(duration: particle.duration).delay(particle.delay)) {
+                    offsetY = screenSize.height + 40
+                    offsetX = particle.drift
+                    rotation = particle.targetRotation
+                }
+                withAnimation(.easeOut(duration: 0.4).delay(particle.delay + particle.duration - 0.4)) {
+                    opacity = 0
+                }
+            }
+    }
+}
diff --git a/overpass/Views/OnboardingView.swift b/overpass/Views/OnboardingView.swift
new file mode 100644
index 0000000..76e7acd
--- /dev/null
+++ b/overpass/Views/OnboardingView.swift
@@ -0,0 +1,89 @@
+import StoreKit
+import SwiftUI
+
+struct OnboardingView: View {
+    @AppStorage("sh.dunkirk.overpass.onboarding_shown") private var onboardingShown = false
+    private let store = StoreManager.shared
+
+    var body: some View {
+        VStack(spacing: 0) {
+            Spacer()
+
+            VStack(spacing: 16) {
+                Image(systemName: "fuelpump.fill")
+                    .font(.system(size: 64))
+                    .foregroundStyle(.red)
+
+                VStack(spacing: 6) {
+                    Text("Overpass")
+                        .font(.largeTitle.bold())
+                    Text("Find the cheapest gas near you.")
+                        .font(.title3)
+                        .foregroundStyle(.secondary)
+                }
+            }
+
+            Spacer()
+
+            Text("I strongly feel that you should never have to make a decision on whether you want to buy something without trying it first so you have complete access for the next 15 days! Try it and hopefully you will love it but if not then you don't have to pay a dime :)")
+                .font(.body)
+                .foregroundStyle(.secondary)
+                .multilineTextAlignment(.center)
+                .padding(.horizontal, 40)
+
+            Spacer()
+
+            VStack(spacing: 16) {
+                Button {
+                    onboardingShown = true
+                } label: {
+                    Text("Go find some gas!")
+                        .font(.headline)
+                        .frame(maxWidth: .infinity)
+                        .frame(height: 50)
+                }
+                .buttonStyle(.borderedProminent)
+
+                Text("15-day free trial, then \(store.product?.displayPrice ?? "$2.99") once. No subscription.")
+                    .font(.footnote)
+                    .foregroundStyle(.secondary)
+                    .multilineTextAlignment(.center)
+
+                Divider()
+                    .padding(.vertical, 4)
+
+                Button {
+                    Task {
+                        try? await store.purchase()
+                        if store.isUnlocked { onboardingShown = true }
+                    }
+                } label: {
+                    if store.isPurchasing {
+                        ProgressView()
+                    } else {
+                        Text("Buy Now — \(store.product?.displayPrice ?? "$2.99")")
+                    }
+                }
+                .font(.subheadline.weight(.medium))
+                .disabled(store.isPurchasing || store.product == nil)
+
+                Button("Restore Purchase") {
+                    Task {
+                        await store.restore()
+                        if store.isUnlocked { onboardingShown = true }
+                    }
+                }
+                .font(.footnote)
+                .foregroundStyle(.tertiary)
+            }
+            .padding(.horizontal, 24)
+            .padding(.bottom, 40)
+        }
+        .interactiveDismissDisabled()
+        .onChange(of: store.isUnlocked) { _, unlocked in
+            if unlocked { onboardingShown = true }
+        }
+    }
+}
+
+
diff --git a/overpass/Views/SettingsView.swift b/overpass/Views/SettingsView.swift
index 69a7dfb..5e2c0a5 100644
--- a/overpass/Views/SettingsView.swift
+++ b/overpass/Views/SettingsView.swift
@@ -80,7 +80,7 @@ struct SettingsView: View {
                 let days = storeManager.daysRemainingInTrial
                 LabeledContent("Free Trial") {
                     Text("\(days) day\(days == 1 ? "" : "s") remaining")
-                        .foregroundStyle(days <= 2 ? .orange : .secondary)
+                        .foregroundStyle(days <= 3 ? .orange : .secondary)
                 }
             }
 
@@ -154,6 +154,7 @@ struct SettingsView: View {
 private struct DeveloperSettingsSheet: View {
     let api: APIClient
 
+    @AppStorage("sh.dunkirk.overpass.onboarding_shown") private var onboardingShown = false
     @State private var baseURL: String = ""
     @State private var deviceSecret: String = ""
     @State private var registrationError: String?
@@ -202,6 +203,12 @@ private struct DeveloperSettingsSheet: View {
                         }
                     }
                 }
+
+                Section("Onboarding") {
+                    Button("Show Onboarding Again") {
+                        onboardingShown = false
+                    }
+                }
             }
             .navigationTitle("Developer")
             .navigationBarTitleDisplayMode(.inline)
diff --git a/overpass/overpass.xcodeproj/project.pbxproj b/overpass/overpass.xcodeproj/project.pbxproj
index c8924d9..f24a9d9 100644
--- a/overpass/overpass.xcodeproj/project.pbxproj
+++ b/overpass/overpass.xcodeproj/project.pbxproj
@@ -32,6 +32,8 @@
 		0B7A9C090000000000000000 /* RouteEditorView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0B7A9C080000000000000000 /* RouteEditorView.swift */; };
 		0BAA1C010000000000000000 /* StoreManager.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0BAA1C000000000000000000 /* StoreManager.swift */; };
 		0BAA1C030000000000000000 /* PaywallView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0BAA1C020000000000000000 /* PaywallView.swift */; };
+		0BAA1C050000000000000000 /* OnboardingView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0BAA1C040000000000000000 /* OnboardingView.swift */; };
+		0BAA1C070000000000000000 /* ConfettiView.swift in Sources */ = {isa = PBXBuildFile; fileRef = 0BAA1C060000000000000000 /* ConfettiView.swift */; };
 /* End PBXBuildFile section */
 
 /* Begin PBXFileReference section */
@@ -60,6 +62,8 @@
 		0B7A9C080000000000000000 /* RouteEditorView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = RouteEditorView.swift; sourceTree = "<group>"; };
 		0BAA1C000000000000000000 /* StoreManager.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = StoreManager.swift; sourceTree = "<group>"; };
 		0BAA1C020000000000000000 /* PaywallView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = PaywallView.swift; sourceTree = "<group>"; };
+		0BAA1C040000000000000000 /* OnboardingView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = OnboardingView.swift; sourceTree = "<group>"; };
+		0BAA1C060000000000000000 /* ConfettiView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ConfettiView.swift; sourceTree = "<group>"; };
 /* End PBXFileReference section */
 
 /* Begin PBXFrameworksBuildPhase section */
@@ -125,6 +129,8 @@
 				0B5E3B4D2F75B002005F7F70 /* StationDetailView.swift */,
 				0B5E3B4E2F75B002005F7F70 /* StationRow.swift */,
 				0BAA1C020000000000000000 /* PaywallView.swift */,
+				0BAA1C040000000000000000 /* OnboardingView.swift */,
+				0BAA1C060000000000000000 /* ConfettiView.swift */,
 			);
 			path = Views;
 			sourceTree = "<group>";
@@ -236,6 +242,8 @@
 				0B7A9C090000000000000000 /* RouteEditorView.swift in Sources */,
 				0BAA1C010000000000000000 /* StoreManager.swift in Sources */,
 				0BAA1C030000000000000000 /* PaywallView.swift in Sources */,
+				0BAA1C050000000000000000 /* OnboardingView.swift in Sources */,
+				0BAA1C070000000000000000 /* ConfettiView.swift in Sources */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
diff --git a/overpass/overpassApp.swift b/overpass/overpassApp.swift
index 3440a8c..86c79d5 100644
--- a/overpass/overpassApp.swift
+++ b/overpass/overpassApp.swift
@@ -55,6 +55,8 @@ struct overpassApp: App {
     private let storeManager = StoreManager.shared
     @Environment(\.scenePhase) private var scenePhase
 
+    @AppStorage("sh.dunkirk.overpass.onboarding_shown") private var onboardingShown = false
+
     var body: some Scene {
         WindowGroup {
             ContentView()
@@ -67,13 +69,25 @@ struct overpassApp: App {
                     await storeManager.load()
                 }
                 .fullScreenCover(isPresented: .init(
-                    get: { !storeManager.hasAccess },
+                    get: { !onboardingShown },
+                    set: { _ in }
+                )) {
+                    OnboardingView()
+                }
+                .fullScreenCover(isPresented: .init(
+                    get: { onboardingShown && !storeManager.hasAccess },
                     set: { _ in }
                 )) {
                     PaywallView()
                 }
+                .overlay {
+                    if storeManager.justPurchased {
+                        ConfettiView()
+                    }
+                }
         }
         .onChange(of: scenePhase) { _, phase in
+            storeManager.isAppActive = phase == .active
             if phase == .active {
                 Task { await BackgroundRefreshService.refreshIfNeeded() }
             }
-- 
2.51.2