Chef It is a native iOS app that turns whatever's sitting in your fridge into dinner. Snap a photo of your pantry, let on-device + cloud vision detect every ingredient, and get instant AI-matched recipes you can actually cook right now — no extra grocery run required.
Built end-to-end in 36 hours at ConHacks 2026 🏆.
Less food waste. Less decision fatigue. More cooking.
- 📸 Pantry Scanning — Computer-vision ingredient detection from a single photo
- 🧠 Smart Matching — Recipe scoring engine ranks suggestions by what you already own
- 🥬 Ingredient Intake — Manual add, undo, rename, smart suggestions, persistent store
- 🍳 Recipe Discovery — Edamam-powered search + curated seed recipes
- ❤️ Favorites & Saved — Persistent recipe library across sessions
- 🛒 Shopping List — Auto-generated for missing ingredients
- 👨🍳 Cooking Mode — Step-by-step guided cooking flow
- 🌐 Social Feed — Share dishes, comment, review, build a community
- 🔐 Auth — Email, Google Sign-In, Apple Sign-In
- 🔔 Notifications — Engagement + cooking reminders
┌─────────────────────────────────────────────┐
│ iOS App (SwiftUI · iOS 17+) │
│ └─ App/ChefIt/ │
│ screens · navigation · design tokens │
├─────────────────────────────────────────────┤
│ ChefItKit (SwiftPM library) │
│ └─ Sources/ChefItKit/ │
│ • Features/ Scan · Auth · Recommend │
│ • Services/ Edamam · Vision · Auth │
│ • Matching/ RecipeMatcher · Scoring │
│ • Models/ Ingredient · Recipe │
│ • Normalization/ IngredientNormalizer │
└─────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────┐
│ Backend (Node.js · Express · PostgreSQL) │
│ └─ backend/ │
│ auth · users · posts · reviews · │
│ comments · Cloudinary uploads │
└─────────────────────────────────────────────┘
|
|
|
- macOS with Xcode 15+
xcodegen:brew install xcodegen- Node.js 18+ and PostgreSQL 16
- Edamam API key (sign up)
git clone https://github.com/MatthewKim07/chef-it.git
cd chef-it
# Fill in API keys
cp Secrets.xcconfig.template Secrets.xcconfig
# Generate the .xcodeproj (gitignored)
xcodegen generate
# Build & test from CLI
swift build
swift test
# Or open in Xcode
open ChefIt.xcodeprojRequired keys in Secrets.xcconfig:
EDAMAM_APP_ID = your_id
EDAMAM_APP_KEY = your_key
GOOGLE_CLIENT_ID = your_google_oauth_id
GEMINI_API_KEY = optional
OPENAI_API_KEY = optional
AUTH_BASE_URL = http://127.0.0.1:3000
cd backend
npm install
cp .env.example .env # fill in DB + JWT + OAuth secrets
npm run schema # init PostgreSQL schema
npm run dev # localhost:3000
⚠️ After everygit pullor branch switch, re-runxcodegen generate. The.xcodeprojis gitignored.
chef-it/
├── App/ChefIt/ # SwiftUI app — screens, navigation, theme
├── Sources/ChefItKit/ # Core library (SwiftPM)
│ ├── Features/ # Scan · Auth · Recommendations
│ ├── Services/ # Edamam · Vision · Auth · Posts · Reviews
│ ├── Matching/ # Recipe scoring engine
│ ├── Models/ # Ingredient · Recipe · ScanResult
│ ├── Normalization/ # IngredientNormalizer · ProteinDetector
│ └── SeedData/ # 17 starter recipes
├── Tests/ChefItKitTests/ # XCTest suite
├── backend/ # Node + Express + Postgres API
│ ├── routes/ # auth · users · posts · reviews
│ └── src/ # entry · db · schema
├── docs/ # Flow diagrams + asset library
├── CHEFIT_BRAND_GUIDELINES.md # Visual identity reference
├── Package.swift # SwiftPM manifest
└── project.yml # XcodeGen config
Chef It has a full design system — sage greens, peach CTAs, rounded everything, Playfair Display + Nunito. See CHEFIT_BRAND_GUIDELINES.md for the complete reference.
| Sage Green | Matcha | Pistachio | Cream | Peach | Honey |
|---|---|---|---|---|---|
#4C5A3E |
#A8C5A1 |
#E8F0E3 |
#FFF7E8 |
#FFB79D |
#FFD26F |
Seasoned with love at ConHacks 2026 by:
 Matthew Kim 🧠 AI · Vision · Pantry Detection |
 Soroush Khajehpour 🎨 iOS UI · SwiftUI · Design |
 Ali Husseini ⚙️ Backend · Database · Recipe API |
Chef It was built in 36 hours at ConHacks 2026 — Conestoga College's flagship hackathon.
MIT — see LICENSE.
Made with 🥑, ☕, and zero sleep.
scan. cook. enjoy. ❤️