Recipe Rememberer is an iPhone and iPad app for scanning printed recipe cards, detecting likely duplicates, and saving them into a private on-device library.
This is a vibe-coded project that was iterated quickly and then tightened into a cleaner shipping baseline.
- Captures front and back photos of a printed recipe card
- Runs on-device OCR over both photos
- Detects recipe title and subtitle from the front card
- Checks the detected recipe against saved recipes with fuzzy text matching
- Supports
Ask FirstandAuto Savesave modes - Stores recipe records locally with
SwiftDataand captured photos in Application Support - Lets you preview, share, rename, and delete saved recipes
- Swift 6
- SwiftUI
- SwiftData
- Vision
- AVFoundation
- XCTest for app and UI coverage
- Swift Testing for core package coverage
- Xcode 26.3 or later
- iOS 26.0 or later
- A real iPhone or iPad for camera capture
The app can run in Simulator. Mocked scanning requires the explicit launch arguments below; a normal simulator run does not enable mocks automatically.
- Open
RecipeRememberer.xcodeprojin Xcode. - Select the
RecipeRemembererscheme. - Choose an iPhone or iPad simulator, or a connected iOS device.
- Press Run.
- Edit the
RecipeRemembererscheme and select its Run action's Arguments settings. - Add and enable
-uiTestMockScannerand-uiTestMockScannerCaptureas two separate launch arguments, not environment variables. - Select an iPhone or iPad simulator and run the app.
- Open Scanner, capture the front and back, and use the explicit commit action after the fixed analysis result appears.
The first argument replaces the camera preview and bypasses camera authorization. The second supplies generated photos and a fixed analysis result. Neither argument enables the other; use both for the complete simulator flow. See the recognition contract for the separate branches.
With Ask First, commit continues to pending save review. With Auto Save, commit attempts to save directly. Duplicate detection and save errors still apply. This flow exercises the capture/save interface without verifying camera hardware or Vision OCR.
Remove or disable both arguments before using the normal camera flow on a device.
xcodebuild -project RecipeRememberer.xcodeproj -scheme RecipeRememberer -destination 'generic/platform=iOS' buildIf swiftlint is installed locally, run:
swiftlint lint --strictRun the app unit and UI tests (RecipeRemembererTests and RecipeRemembererUITests):
xcodebuild -project RecipeRememberer.xcodeproj -scheme RecipeRememberer -destination 'platform=iOS Simulator,name=iPhone 17 Pro' testRun the separate core Swift package tests (RecipeRemembererCoreTests):
swift test --package-path Packages/RecipeRemembererCoreRun both commands to cover the app and package test suites. The Xcode scheme does not include the package test target. The simulator destination must be installed; choose another available destination if needed. These commands are also listed under System Verification.
Before preparing a device build or TestFlight archive, set your own Apple Developer team and bundle identifier in Xcode.
- App contract: app entry, tabs, shared app state, UI test launch helpers
- Recognition contract: scanner capture flow and save review flow
- Library contract: saved recipe list, edit flow, preview/share flow
- Models contract:
SwiftDatamodels and photo persistence - Core package contract: parser, duplicate detection, crop geometry, and layout helpers
- Recipes stay on-device.
- No account is required.
- No analytics or advertising SDKs are included.
- Support draft: SUPPORT.md
- Privacy draft: PRIVACY.md
- App Store metadata draft: AppStoreMetadata.md
Released under the MIT License.
The SwiftUI app captures recipe-card photos, recognizes their text on-device, and passes capture payloads to AppModel for duplicate checking and save decisions. Saved recipes use SwiftData, while front/back images are separate files in Application Support. The library reads saved records and offers editing, preview, sharing, and deletion. See the component contracts for implementation guards and failure paths.
- Application: composition, shared state, features, and persistence models.
- Packages: the independently testable
RecipeRemembererCoreSwift package. - Xcode project: app and XCTest targets. Its source build phase compiles the core source files directly into the app; the app does not depend on the SwiftPM library product.
- Shared scheme: app build and the
RecipeRemembererTests/RecipeRemembererUITeststestables. Test-only and asset directories have no generated contracts.
The application contract rolls up app-module interfaces; the core source contract distinguishes public package APIs from internal geometry helpers. There are no production source files directly in this repository root.
[RecipeRememberer/App/AppModel.swift:AppModel]is@MainActorand@Observable;[RecipeRememberer/App/RecipeRemembererApp.swift:RecipeRemembererApp]owns and injects it using SwiftUI state/environment.[RecipeRememberer/Models/StoredRecipe.swift:StoredRecipe.refreshNormalizedFields()]appliesRecipeNormalizer.normalizedKey(for:)to title/subtitle during initialization and detail updates. Duplicate detection compares these stored keys (DuplicateRecipeDetector.isDuplicate(title:subtitle:among:)).[RecipeRememberer/App/RecipeRemembererApp.swift:RecipeRemembererApp.modelContainer]configures in-memory storage for seeded/mock-capture UI test launches; production uses the default persistent configuration.[Packages/RecipeRemembererCore/Package.swift:package]requires Swift tools 6.2, Swift language mode 6, and iOS 26.0 / macOS 15.0 minimum platforms. The Xcode project sets the iOS deployment target to 26.0 and Swift language mode to 6.
[RecipeRememberer/Features/Recognition/RecipeCardCameraView.swift:RecipeCardCameraView]uses camera capture;[RecipeRememberer/Features/Recognition/RecipePhotoAnalyzer.swift:RecipePhotoAnalyzer.analyze]performs on-device OCR.[RecipeRememberer/App/AppModel.swift:AppModel]mutates observable state and saves/inserts/deletes SwiftData records.[RecipeRememberer/Models/RecipePhotoStore.swift:RecipePhotoStore]creates and accessesApplication Support/RecipePhotos; writes are atomic per file, not transactional across both photos and SwiftData.[RecipeRememberer/App/AppModel.swift:AppModel.deleteRecipe(_:using:)]saves the record deletion before removing that recipe’s photo files. Failed metadata deletion retains the record/photos; later photo cleanup failure is reported separately. Persistence recovery and cleanup boundaries are documented in the App and Models contracts.- Library sharing presents a system share flow (
RecipeRememberer/Features/Library/SavedRecipePhotoGallerySection.swift).
Run from this repository root:
swift test --package-path Packages/RecipeRemembererCore
xcodebuild -project RecipeRememberer.xcodeproj -scheme RecipeRememberer -destination 'platform=iOS Simulator,name=iPhone 17 Pro' testThe simulator command requires that device/runtime to be installed; select another available destination if needed. These commands target the package manifest and shared Xcode scheme, respectively. Documentation bootstrap validates contracts and links without claiming a fresh application test run.
The release evidence records the current code changes, exact checks, local archive, device-install result, and outstanding submission requirements. An offline privacy/support screen is available from Scanner. App Review submission and approval remain pending.