Appendix V: Take A Chance On Me (Shop Manual)

Status: Live on the App Store (US + Canada only). v2.0. App Apple ID 6753626820. Bundle ID com.inkwell.TakeAChanceOnMe. iPhone + iPad universal. GPL v3. Public repo at github.com/fluhartyml/TakeAChanceOnMeV1.0.2 (the V1.0.2 in the repo name is historical; the project is on v2.0). Take A Chance On Me is the smallest-scale shipping reference app in the book's roster. Three Swift files do the entire job: a random-number generator with a gradient background, a dice-bag picker, and an about / feedback footer. Book 06 (Controls) Live Reference reaches for this app's DiceBagView and FeedbackView when it needs the most minimal possible production examples of Toggle, Button, and segmented Picker.

What it is

An iPhone / iPad app that picks a random number between 1 and a maximum the user types in. The number-entry surface is a number-pad text field with a "Done" toolbar button to dismiss; the result renders as a large, comma-formatted number on a gradient purple-to-blue background. v2.0 added a Dice Bag view where the user toggles which standard dice (d4, d6, d8, d10, d12, d20, d100) are included, taps Generate, and gets a per-die roll plus a sum. That's the whole app.

Architecture overview

Three primary Swift files plus the About and Feedback surfaces. No SwiftData, no network, no entitlements.

• App entry: TakeAChanceOnMeApp.swift — @main scene.
• Number generator: ContentView.swift — the main random-1-to-N view. Number pad input field with a "Done" toolbar Button, tap-to-dismiss-keyboard onTapGesture on the background, gradient background via LinearGradient, large result display with NumberFormatter grouping.
• Dice Bag (v2.0): DiceBagView.swift — per-die enable Toggles for d4 through d100, a Generate Button, a Clear Results Button, and a per-roll results list. The chapter's reference example of stock Toggle + Button driving a tiny piece of stateful UI without any framework gymnastics.
• About: AboutView.swift — standard about page (icon, version, credit).
• Feedback: FeedbackView.swift — segmented Picker for feedback type (Bug Report / Feature Request / Other), TextEditor for the message body, mail composer to send.

Why Book 06 points here

Book 06 (Controls) explicitly reaches for this app as the smallest-scale shipping source for Button, Toggle, and Picker. The chapter's claim: you don't need a complex app to demonstrate the control primitives. DiceBagView uses Toggle per die (binary state, drives a published @Observable property) and Buttons for the actions (Generate, Clear Results, keyboard Done). FeedbackView uses a segmented Picker with three cases. That's the entire chapter's surface mapped to one app you can build and read end-to-end in under an hour.

Smallness is the teaching. Larger apps in the roster (CryoTunes, LockBox) demonstrate the same primitives at scale; this one demonstrates them at the floor.

The number-pad keyboard pattern

Worth singling out for the chapter on input: TextField bound to a numeric state, .keyboardType(.numberPad) to lock to digits, .toolbar { ToolbarItemGroup(placement: .keyboard) { Spacer(); Button("Done") { ... } } } for the Done button that gives the user a way out (the number pad has no Return key), plus an onTapGesture on the surrounding view to dismiss the keyboard when the user taps the background. Four small modifiers and a toolbar item, all standard SwiftUI — no first-responder management, no UIResponder tricks.

Build + deployment

• App name: Take A Chance On Me.
• Bundle ID: com.inkwell.TakeAChanceOnMe — the bundle uses the com.inkwell namespace shared with the Bible reader and InkwellJournal sibling apps.
• App Apple ID: 6753626820.
• App Store availability: US + Canada only (intentional; not all countries activated).
• Platforms: iPhone + iPad universal.
• Frameworks: SwiftUI, MessageUI (feedback composer).
• Privacy: No data collected. No network. No analytics.

Known gotchas

• Repo name carries the old version number. fluhartyml/TakeAChanceOnMeV1.0.2 — the V1.0.2 was meaningful when the repo was first created and the app was at that build; v2.0 added DiceBagView and the repo name stayed historical. Worth knowing when linking; not worth renaming.
• The numberPad keyboard has no Return key. Without the explicit Done toolbar item, the user has no way to dismiss the keyboard on iPhone other than tapping elsewhere. The Done toolbar item is the canonical fix and the source file shows it in context.
• US + Canada only on App Store. Other regions can clone-and-build but can't install from the store. Not a bug — a deliberate availability choice that's documented in the App Store Connect submission.
• v1.0.2 history is preserved on disk. Earlier folder structure exists under the repo name; the current app is in TakeAChanceOnMe/ at the repo root.

Sources

• Project source: github.com/fluhartyml/TakeAChanceOnMeV1.0.2 (verified 2026-05-10).
• Live on App Store: App Apple ID 6753626820, US + Canada.
• Canonical roadmap: TakeAChanceOnMe/TakeAChanceOnMe_DeveloperNotes.swift in the project repo.
• Source Tour 26 in Part VII walks through this app's architecture.
• Book 06 cross-reference: DiceBagView (Toggle + Button) and FeedbackView (segmented Picker).
• Book 02 cross-reference: smallest-scale SwiftUI view-protocol example.