Skip to content

About

Privacy-first iOS food journal with AI-powered nutrition scanning. SwiftUI + Liquid Glass, Gemini AI, SwiftData, CloudKit.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Repository files navigation

OpenFoodJournal

A privacy-first iOS food journal with AI-powered nutrition scanning. Point your camera at a nutrition label or a plate of food and get instant macro/micronutrient tracking — no manual data entry required.

Built with SwiftUI, SwiftData, and Liquid Glass for iOS 26+.


Features

AI-Powered Scanning

  • Nutrition label scan — Capture up to 4 angles of a product label. Gemini Flash combines the photos to extract macros and micronutrients.
  • Food photo recognition — Capture up to 4 angles of one meal portion. Gemini combines the photos to estimate calories, protein, carbs, fat, and common micros.
  • AI food search — Search by text from the Food Bank. Gemini uses Google Search grounding to find nutrition data, then opens the editable review form.
  • Review before logging — Every scan result is editable before committing to your journal.

Daily Journal

  • Weekly calendar strip — Horizontally scrollable with momentum snapping, progress rings per day, 52 weeks of history.
  • Macro summary bar — At-a-glance calorie count + protein/carbs/fat progress rings + two configurable micronutrient ring slots (long-press to edit).
  • Meal sections — Breakfast, lunch, dinner, snack. Swipe to edit or delete entries. Tap to view full nutrition detail.
  • Radial action menu — Bottom-center FAB fans out into Scan / Manual Entry / Containers / Food Bank shortcuts.

Food Bank

  • Save foods for reuse — Any scanned or manually entered food can be saved to your personal library.
  • Composite foods — Combine saved foods into one reusable portion while keeping ingredient snapshots independent from future source-food edits.
  • Nutrition calculators — Build restaurant or brand calculators with runtime groups, user-defined portion labels, Gemini OCR import from screenshots, reusable presets, and journal logs that snapshot the selected nutrition.
  • Search, sort, log — Find saved foods by name, sort by last used or alphabetical, swipe right to log directly.
  • Cosmetic archive — Foods not logged in over two weeks hide from the main list, but stay searchable and available from the Archive menu.
  • Serving mappings — Define per-food unit conversions (e.g., "1 cup = 244g") for accurate re-logging in different portions.

Container Tracking

  • Weight-based tracking — For bulk items like protein tubs or cereal boxes. Enter start weight, weigh when done, and the app derives exact consumption.
  • Recently used — Quick access to the last 8 foods you've tracked in containers.

Micronutrient Tracking

  • 30 FDA-recognized nutrients — Vitamins A through K, minerals, fiber, cholesterol, and more, each with daily value targets.
  • Configurable summary rings — Choose which two micronutrients appear on your daily dashboard.
  • Full breakdown view — Expandable progress bars for every tracked micronutrient.

History & Charts

  • Calendar grid — Month view with color-coded progress indicators per day.
  • Macro bar charts — Weekly/monthly trends for each macro, with over-goal visual indicators.
  • Nutrition detail — Tap any day to see full macro and micro breakdowns.

Health & Sync

  • Apple HealthKit — Opt-in idempotent sync for calories, protein, carbs, fat, and 10+ micronutrients. Writes use deterministic sample identifiers so edits replace OpenFoodJournal-owned samples instead of duplicating them. Reads active energy burned for net calorie display.
  • iCloud sync — Local-first SwiftData with automatic CloudKit sync across all your Apple devices.
  • Optional Turso integration — Push a debuggable copy of local/iCloud app data and append redacted AI diagnostics to your own Turso database for SQL inspection. SwiftData remains the source of truth for app state.
  • Spreadsheet CSV export — Export journal entries with stable IDs, ISO dates, macros, serving basics, and micronutrient columns for analysis.
  • Backup export/import — Versioned JSON backup restores journal entries, Food Bank foods, containers, preferences, and goals by UUID without duplicating repeated imports.
  • Appearance themes — Blue, Harvest Orange, Leaf Green, and Berry Purple tint the app; the Log Food sheet pairs the selected accent with a compact quantity, nutrition, micronutrient, unit, and meal workflow.
  • AI diagnostic export — Export the last 14 days of redacted scan, search, Assistant, tool, latency, token, and cost telemetry from your configured Turso database. Prompts, answers, journal/HealthKit values, sources, attachments, and API keys are excluded.
  • Gemini usage total — Settings shows a local running estimate of Gemini token cost and token usage, with reset controls.

Sources & Disclaimers

  • FDA citations — Daily Value percentages linked to 21 CFR §101.9 and FDA guidelines.
  • AI accuracy notes — Inline disclaimers on scan results noting estimates may differ from actual values.
  • Health disclaimer — Clear "Not Medical Advice" notice with links to all data sources.

Architecture

┌─────────────────────────────────────────────┐
│  iOS App (SwiftUI + SwiftData)              │
│                                             │
│  OpenFoodJournalApp                         │
│    ├─ NutritionStore (CRUD + queries)       │
│    ├─ ScanService (camera → Gemini REST)    │
│    ├─ TursoMirrorService (mirror + AI logs) │
│    ├─ HealthKitService (Apple Health)       │
│    ├─ KeychainService (API key storage)     │
│    └─ UserGoals (@Observable + @AppStorage) │
│                                             │
│  ContentView (4-tab TabView)                │
│    ├─ Journal  → DailyLogView               │
│    ├─ Food Bank → FoodBankView              │
│    ├─ History  → HistoryView                │
│    └─ Settings → SettingsView               │
└──────────────┬──────────────────────────────┘
               │
    ┌──────────┴──────────┐
    │ HTTPS (BYOK)        │ CloudKit (automatic)  │ optional SQL-over-HTTP
    ▼                     ▼                       ▼
┌────────────┐  ┌─────────────────┐       ┌─────────────────┐
│ Gemini API │  │ iCloud Private  │       │ User Turso DB   │
│ (Google)   │  │ Database        │       │ mirror + AI logs│
└────────────┘  └─────────────────┘       └─────────────────┘

Local-first: SwiftData writes happen immediately for instant UI. CloudKit sync is automatic — the private database keeps all devices in sync transparently.

BYOK (Bring Your Own Key): Users provide their own Gemini API key (free from aistudio.google.com). The key is stored in the iOS Keychain and API calls go directly from the device — no proxy server involved.

Optional Turso integration: Users can add their own Turso database URL and auth token in Settings → Data → Turso Integration. The app uses Turso SQL-over-HTTP directly. Journal/configuration/usage tables are push-only generation mirrors; detailed AI telemetry uses a separate append-only table with 14-day retention and a bounded local-only delivery outbox. Turso is never the source of truth for conversations or nutrition data.

Service injection: All services are created at app launch and passed through SwiftUI's @Environment. No singletons.


Data Models

Model Purpose
DailyLog One per day, keyed by midnight-normalized date. Owns entries via cascade delete.
NutritionEntry Single food log — macros, micros, brand, serving info, optional calculator selection summary, and Apple Health sync metadata.
SavedFood Reusable food template in the Food Bank. Supports single foods, composite foods, and runtime nutrition calculators, plus last-used and archive display state.
TrackedContainer Weight-based container. Snapshots food nutrition at creation, derives consumption from weight delta.
AIDiagnosticEvent Provider-neutral redacted telemetry envelope written directly to Turso. Legacy GeminiScanLog/ChatDiagnosticSpan models remain only for one-time CloudKit migration compatibility.
GeminiCostAccumulator Local running estimate of Gemini token cost and token usage, shown in Settings.
UserGoals Daily calorie/protein/carbs/fat targets. Persisted via @AppStorage.

Tech Stack

Layer Technology
UI SwiftUI + Liquid Glass (iOS 26)
Local Data SwiftData (@Model)
State @Observable + @Environment
AI Google Gemini latest aliases (gemini-flash-latest for labels/lite scans/search, gemini-pro-latest for Pro food photos/search) — BYOK
Sync CloudKit (iCloud Private Database), optional Turso SQL-over-HTTP mirror
Security iOS Keychain (API key storage)
Health Apple HealthKit

Getting Started

Prerequisites

  • Xcode 26+ (macOS)
  • A Google Gemini API key (optional, for scan functionality — get one free at aistudio.google.com)

Build & Run

# Clone the repo
git clone https://github.com/kvn8888/OpenFoodJournal.git
cd OpenFoodJournal

# Build from terminal
xcodebuild -project OpenFoodJournal.xcodeproj \
  -scheme OpenFoodJournal \
  -destination generic/platform=iOS \
  build

Or open OpenFoodJournal.xcodeproj in Xcode and run on a simulator or device.

Note: The server/ directory contains a legacy Express.js proxy from an earlier architecture. It is not used by the app. The current app communicates directly with Gemini, CloudKit, and optional Turso SQL-over-HTTP — no proxy server is required to build, run, or use OpenFoodJournal.


Project Structure

OpenFoodJournal/
├── Models/           # SwiftData models + enums + mock data
├── Services/         # NutritionStore, ScanService, TursoMirrorService, HealthKitService, KeychainService
├── Views/
│   ├── DailyLog/     # Journal tab — calendar strip, macro bar, meal sections
│   ├── FoodBank/     # Saved foods — search, sort, edit, log
│   ├── Container/    # Weight-based container tracking
│   ├── History/      # Calendar grid + macro charts
│   ├── ManualEntry/  # Manual food logging + entry editing
│   ├── Scan/         # Camera capture + scan result review
│   ├── Settings/     # Goals editor, app settings, sources & disclaimers
│   ├── Onboarding/   # 6-page onboarding with API key setup
│   └── Shared/       # Reusable components (MacroRingView, RadialMenuButton, etc.)
├── Assets.xcassets/  # App icon + accent color
└── ContentView.swift # Root 4-tab navigation

License

This project is licensed under the AGPL-3.0.

About

Privacy-first iOS food journal with AI-powered nutrition scanning. SwiftUI + Liquid Glass, Gemini AI, SwiftData, CloudKit.

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages