▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

grain — local-first iOS receipt scanner. scan · parse · track · analyze.

                          PROOF-OF-CONCEPT
        
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓

g r a i n v0.1.0 · poc scan → ocr → parse save → browse → analyze local-only · no cloud

F L O W scan → ocr → parse → save → browse → analyze D O C S | - current state | - redesign spec | - ADRs | - changelog N A V | - what it does | - stack | - run locally | - status N O T E S → mvp delta parser · errors · images · edit → arch decisions 5 adrs · zero deps · local-only → changelog v0.1.0 · poc · notifications → redesign spec typography · tokens · wireframes

---

What it does

• Scan receipts — photograph a paper receipt and extract merchant, items, prices, and tax with Apple Vision OCR.
• Track spending — view totals and breakdowns by category, merchant, and brand.
• Watch prices — see item-level price history across purchases.
• Index entities — browse products, brands, and retailers pulled from receipt data.
• Stay local-first — all storage and processing on device. No cloud, no accounts.

Stack

Layer	Tech
UI	SwiftUI
Data	SwiftData
OCR	Apple Vision
Charts	Swift Charts
Storage	Local-only
Dependencies	Apple frameworks only

iOS 17+ · Swift 5.9+ · Xcode 15+

Run locally

git clone https://github.com/larralapid/grain.git
cd grain
open grain.xcodeproj

Build the grain target in Xcode and run on an iOS 17+ simulator or device.

Status

Proof of concept. The core loop exists: scan, OCR, parse, save, browse, and analyze.

Biggest gaps to close for MVP: manual receipt entry, full edit flow from scan proof, receipt image persistence, stronger parser reliability, and better user-facing error states.

See docs/Current-State.md for the full assessment and MVP delta.

Docs

• Current State
• Redesign Spec
• Architecture Decisions
• Changelog

License

All rights reserved. See LICENSE.