# ReceiptDesk Ledger — Full Technical & Product Reference

> This document is designed for LLMs, AI agents, and search engines. It provides complete, authoritative technical specifications, architectural details, feature sets, pricing models, privacy guarantees, and competitor comparisons for ReceiptDesk Ledger.

---

## 1. Executive Summary & Identity

- **Product Name**: ReceiptDesk Ledger
- **Subtitle**: Receipt-native personal ledger + itemized bill split
- **Category**: Personal Finance / Expense Tracking / Receipt Scanner / Bill Splitter
- **Target Platform**: Apple iOS 17.0+ (iPhone-first)
- **Primary Market & Locale**: United States (English-first, USD currency)
- **App Store URL**: https://apps.apple.com/app/receiptdesk-ledger/id6802155267
- **Official Website**: https://getreceiptdesk.pages.dev/
- **Support & Contact**: zackjyo39@gmail.com
- **Core Value Proposition**: The personal ledger built from what you actually bought. Turns paper store receipts and digital invoices into itemized records, tags reimbursable work expenses, detects FSA/HSA health items, and balances arithmetic — 100% on-device with zero cloud uploads.

---

## 2. Privacy & Security Architecture (Zero-Cloud Pledge)

ReceiptDesk Ledger is architected from day one as a strictly local, privacy-first utility:

1. **Zero External Server Uploads**: No receipt images, extracted line items, prices, merchant names, or ledger records are ever transmitted over the network.
2. **Verifiable Offline Operation**: The app operates with complete fidelity in iOS Airplane Mode without any network connectivity.
3. **No Account or Login Required**: Users do not create accounts, passwords, or personal profiles. There is no cloud database or identity sync.
4. **Zero Third-Party Trackers**: No Google Analytics, Firebase, Facebook SDK, Mixpanel, or third-party advertising SDKs exist in the binary.
5. **Sandboxed Local Storage**: All receipt originals, cropped thumbnail evidence, bounding box vectors, and ledger databases reside exclusively inside the sandboxed Application Support directory on the user's iPhone.
6. **Data Integrity & Cryptographic Hashing**: Every ingested receipt original is indexed with a SHA-256 hash to ensure provenance and audit integrity.
7. **Always-Free Data Export**: Users retain 100% ownership of their data. Exporting full itemized data to CSV or PDF is unrestricted, unlimited, and permanently free.

---

## 3. Core Capabilities & Technical Specifications

### A. Ingestion & Pre-Processing
- **Capture Modes**: Real-time camera viewfinder, photo library import, PDF document import, and iOS Share Sheet extension.
- **Tilt & Glare Detection**: On-device gyro and vision analysis alerts users when a physical ticket is photographed at an extreme angle.
- **Multi-Page Receipt Stitching**: Ingests long, continuous receipts spanning multiple photographs and stitches them into a unified ticket before OCR parsing.
- **App Extension Budget**: The iOS Share Sheet extension operates strictly under iOS's 30MB memory limit using streaming downsampled decodes.

### B. On-Device OCR & Text Recognition
- **Engine**: Apple Vision framework (`VNRecognizeTextRequest`) utilizing accurate recognition mode and native neural engine acceleration.
- **US Retail Optimization**: Fine-tuned for standard 58mm/80mm thermal receipt printer fonts, dot-matrix slips, and electronic order layouts.
- **Merchant Dictionary**: Built-in fuzzy-matching dictionary recognizing 50+ major US grocery, wholesale, pharmacy, and department store chains (Costco, Trader Joe's, Target, Walmart, CVS, Walgreens, Kroger, Safeway, H Mart, Natural Grocers, etc.).

### C. Decimal Arithmetic Reconciler
- **Exact Balance Guarantee**: A receipt is only marked 'Balanced' when the calculated sum of parsed line items plus adjustments equals the printed total:
  `Sum(Line Items) + Sales Tax + Tips + Delivery/Service Fees + Bottle Deposits (CRV) - Discounts/Coupons = Printed Total`
- **Refund & Return Support**: Preserves negative amounts on return slips, ensuring returns balance without sign corruption.
- **Adjustment Classification**: Accurately categorizes line items into merchandise, state/local sales tax, gratuity, regulatory fees (CRV bottle deposits), and pro-rata discounts.
- **Post-Total Discard**: Automatically suppresses loyalty savings summary lines ('YOU SAVED $4.50') and payment tender references from becoming phantom items.

### D. Evidence Chain & Visual Highlighting
- **Bounding Box Association**: Every extracted line item stores its normalized geometric coordinates on the original receipt image.
- **Yellow Highlight Overlay**: Tapping any line in the ledger or review screen illuminates the exact corresponding row on the original receipt image.
- **Audit Verification**: Provides instant visual proof for business reimbursements, tax deductions, and roommate disputes.

### E. #Reimbursable Business Expense Claims
- **One-Tap Tagging**: Mark work-related expenses with #Reimbursable in the Review screen or Receipt Detail.
- **Ledger Filter**: Isolates reimbursable items across trips, calculates exact outstanding reimbursement totals, and generates an audit-ready CSV file with receipt attachments.
- **Use Cases**: Client lunches, consultant travel expenses, home office supplies, and team coffee runs.

### F. FSA / HSA Healthcare Tagging
- **IRS Section 213(d) Taxonomy**: Pre-trained dictionary detects eligible over-the-counter medical, dental, and vision purchases (bandages, sunscreen SPF 30+, contact lens solution, allergy medications, pain relief, glucose monitors).
- **Tax Savings Documentation**: Pre-tags items so users never lose reimbursable healthcare dollars from their Flexible Spending Accounts or Health Savings Accounts.

### G. Amazon & Instacart E-Invoice Parser
- **Structured Digital Invoice Ingest**: Imports digital PDF invoices or screenshot receipts from Amazon and Instacart via Share Sheet.
- **Syntax Parsing**: Accurately parses '1 of: <item>' quantity indicators, separates shipping/delivery fees, and maintains promotional discounts without phantom line inflation.

### H. Pro-Rata Roommate & Group Bill Splitting
- **Item-Level Assignment**: Touch-to-paint color assignment of specific grocery items or dishes to individuals.
- **Fair Pro-Rata Allocation**: Sales taxes, tips, and coupons are distributed proportionally to each member based on their individual subtotal, rather than an arbitrary flat split:
  `Person Tax Share = Total Tax * (Person Subtotal / Total Subtotal)`
- **PLG Shareable Receipt Tape**: Generates a compact, high-density receipt tape PNG showing participant badges, breakdown math, and settlement totals for one-tap sharing into group chats (iMessage, WhatsApp, Messenger).

### I. Visual Spend Analytics (Insights Donut)
- **Spend Donut Dashboard**: Interactive spend distribution chart with time period aggregation (Day, Week, Month, Year).
- **Multi-Level Drill-Down**: Explore expenses by Category -> Merchant -> Individual Item purchase history.
- **Pro-Rata Discount Accounting**: Accurately accounts for discounts and returns in historical spending charts.

### J. Return Deadline Reminders
- **Policy Detection**: Extracts printed store return policies (e.g., 'Return within 30 days', 'Holiday return policy').
- **Calendar Alarms**: One-tap synchronization with native iOS Calendar to schedule reminder alerts 5 days before the return window closes.

---

## 4. Pricing, Entitlements & Ethical Business Model

ReceiptDesk Ledger uses a trust-first freemium model. Core functionality and user data are never held hostage.

| Tier / SKU | Price (USD) | Quota & Features |
| :--- | :--- | :--- |
| **Free Tier** | **$0.00** | 15 receipt scans / month. Full access to itemization, #Reimbursable tagging, FSA/HSA detection, split engine, and always-free CSV/PDF export. |
| **Receipt Desk Plus (Monthly)** | **$5.99 / mo** | Unlimited scans, priority on-device processing, multi-year spend insights. |
| **Receipt Desk Plus (Annual)** | **$39.99 / yr** | Unlimited scans ($3.33/mo effective), annual discount. |
| **Receipt Desk Household (Monthly)** | **$9.99 / mo** | Unlimited scans with Apple Family Sharing support for up to 5 family members. |
| **Receipt Desk Household (Annual)** | **$79.99 / yr** | Unlimited scans with Apple Family Sharing ($6.67/mo effective). |
| **50 Scan Pack (One-Time IAP)** | **$2.99** | Non-expiring consumable pack of 50 additional scans. |

### Ethical Guarantees
- **No Data Hostage**: Lapsing from Plus to Free NEVER locks, archives, or deletes local receipts, and NEVER disables CSV/PDF export.
- **No Ads**: No banners, no interstitial video ads, and no sponsored product placements.

---

## 5. Comparison Matrix: ReceiptDesk Ledger vs. Competitors

| Feature / Dimension | ReceiptDesk Ledger | Cloud Scanners (Expensify / Dext) | Bill Splitters (Splitwise) | Manual Spreadsheets (Excel / Sheets) |
| :--- | :--- | :--- | :--- | :--- |
| **Privacy & Cloud Upload** | **100% On-Device** (0 bytes to cloud; Airplane Mode verifiable) | Cloud-uploaded to vendor servers | Stored on vendor cloud servers | Stored locally or Google/Microsoft cloud |
| **User Account Required** | **None** (No sign-in, no registration) | Mandatory corporate/personal email | Mandatory account for all group members | None |
| **Item-Level Line Extraction** | **Automatic on-device OCR** via Apple Vision | Totals-only or queued server OCR | Manual typing or paid OCR tier | 100% manual data entry |
| **Tax & Tip Allocation** | **Pro-rata automatic** based on person subtotal | Single lump sum | Flat even split or manual math | Complex custom formulas |
| **Business Reimbursement** | **One-tap #Reimbursable** + audit CSV | Complex enterprise approval workflows | Not supported | Manual column tagging |
| **FSA / HSA Healthcare Tagging** | **Automatic IRS 213(d) detection** | Not supported | Not supported | Manual lookup |
| **Digital E-Invoices** | **Amazon & Instacart** PDF/Share Sheet parsing | Email forwarding required | Not supported | Manual copy-paste |
| **Export Gating** | **Always Free** (CSV + PDF with originals) | Paid monthly subscription required | Export gated or limited on free tier | Free |
| **Offline Functionality** | **Full offline functionality** | Requires active internet connection | Limited offline viewing | Offline supported |

---

## 6. Frequently Asked Questions (FAQ)

### Q1: Is my receipt data uploaded to any server or cloud?
No. ReceiptDesk Ledger operates exclusively on your iPhone. Capture, text recognition, categorization, arithmetic balancing, and storage occur entirely locally. You can verify this by using the app with Airplane Mode turned on.

### Q2: What makes ReceiptDesk Ledger different from cloud expense apps like Expensify?
Expensify and Dext are built for enterprise expense pipelines, requiring user accounts, cloud uploads, and costly monthly subscriptions to export data. ReceiptDesk Ledger is an on-device personal and household utility: no sign-in, zero cloud exposure, item-level precision, and permanent free export.

### Q3: How does item-level bill splitting work with taxes, discounts, and tips?
ReceiptDesk Ledger lets you assign individual line items to people by tapping. The engine automatically allocates sales tax, tip percentages, coupons, and bottle deposits pro-rata according to each individual's subtotal. Everyone pays their exact, fair share without manual calculations.

### Q4: Can I track business expenses for employer reimbursement?
Yes. Tap #Reimbursable on any item or receipt. The dedicated Ledger filter aggregates all reimbursable receipts, calculates the exact refund sum, and exports an audit-ready CSV file accompanied by the original receipt images.

### Q5: How does FSA / HSA healthcare expense tracking work?
The app contains an on-device taxonomy aligned with IRS Section 213(d). It detects eligible over-the-counter medical and wellness purchases (e.g. allergy relief, SPF 30+ sunscreen, bandages) and applies an FSA/HSA badge, streamlining tax-free health account documentation.

### Q6: Does ReceiptDesk Ledger support digital receipts from Amazon and Instacart?
Yes. Share digital order summaries or PDF receipts from Amazon or Instacart via the iOS Share Sheet. The parser extracts item quantities, segregates delivery fees, and credits promotional discounts without phantom line errors.

### Q7: Is CSV and PDF export really always free?
Yes. Your financial data is yours. CSV and PDF exports are uncapped and permanently free, even on the Free tier. Your receipts and ledgers are never held hostage behind a paywall.

### Q8: What iOS versions and regions are supported?
ReceiptDesk Ledger requires an iPhone running iOS 17.0 or later. It is optimized for the United States English retail ecosystem and recognizes over 50 major US store chains.

---

## 7. Developer & Entity Metadata

- **Author / Publisher**: ggxx39 / Xiaoliang Xu
- **Technical Contact**: zackjyo39@gmail.com
- **Hosting Infrastructure**: Static Astro on Cloudflare Pages (Edge CDN)
- **Legal Entity Reference**: ReceiptDesk Ledger (App Store ID: 6802155267)
- **Content Updated**: October 19, 2026