Track your pantry. Discover recipes from what you already have. Save favorites. Ask an AI cooking helper.
Built by a dorm resident, for dorm residents.
0125.1.mp4
Most recipe sites assume a fully stocked kitchen. DormChef flips the flow:
start with what’s in your pantry → get meals that fit your tools, time, and budget.
- 🧺 Pantry tracking with validation (offline via
localStorage) - 🧠 Ingredient-aware discovery with match % scoring (“cook now” at 100%)
- ⭐ Favorites with persistent storage
- 🔎 Filters by meal type, difficulty, and quick “pantry chip” toggles
- 🤖 AI Chat helper (Gemini) for substitutions, steps, and safety tips
- 🌈 Aurora glass UI with light/dark support
- ⚡ Instant navigation (React Router + lazy loading)
- ♿ A11y + performance: desktop Lighthouse typically 95–100
React · Vite · TypeScript · TailwindCSS · React Router
APIs: TheMealDB, Google Gemini (optional)
State: Local component state + localStorage namespaces
Build: ESM, Vite (fast dev, pre-bundled deps)
# 1) Clone
git clone https://github.com/yourname/dormchef.git
cd dormchef
# 2) Install
npm install
# or: pnpm i | yarn
# 3) Configure env
cp .env.example .env.local
# then fill VITE_GEMINI_API_KEY (optional if you don’t use AI chat)
# 4) Run
npm run dev
# open the printed URL