A Vue 3 SPA that turns your pantry into tonight's dinner — ranked by what you actually have, with a guided cook-along mode for when you're ready to start.
- Substitution-aware suggestions — consumes an API that models ingredient substitutions as a graph, so “missing buttermilk but have milk” doesn't tank a recipe's ranking the way a naive exact-match system would.
- Installable, works offline — built as a PWA; your last-fetched suggestions are still viewable with no connection, and the app installs to your home screen or dock like a native app.
- Cook Mode — a full-screen, distraction-free step-by-step view with a built-in per-step timer, distinct from the rest of the app's card-based layout on purpose.
- A real design system, not a component library default — custom design tokens built around a “pantry ledger” visual language; ingredients render as a glanceable shelf of filled or outlined jars rather than a progress bar.
- Vue 3 (Composition API)
- Vue Router, Pinia
- Axios
- vite-plugin-pwa (offline support and installability)
- Vuetify
- Hand-built Sass design tokens for the signature visual elements
- Auth (register, login, and logout) against a token-based API
- Pantry management with debounced ingredient autocomplete
- Ranked, filterable recipe suggestions
- Full recipe detail with have and missing ingredient states
- Guided Cook Mode with per-step timers
- Installable PWA with offline suggestion caching
Run the API first, seed the recipe catalog, then start this frontend:
# in FridgeRaidAPI
php artisan migrate
php artisan db:seed --class=RecipeImportSeeder
php artisan serve
# in FridgeRaid
npm install
npm run devCreate an account, add a few ingredients, and open Suggestions to see the substitution-aware ranking. Then open a recipe and switch to Cook Mode.
npm install
npm run devRequires the API running locally, or point VITE_API_URL in a .env file at a deployed instance.
See docs/quality.md for the accessibility, performance, and release checklist.
npm run buildThe build outputs static files to dist/, so it can be served from any static host. The same build runs automatically in GitHub Actions.
npm run buildSet VITE_API_URL to your deployed API before building.
The visual language is built around one idea: ingredients should read like items on a shelf, not entries in a progress bar. Recipe titles are set in italic Fraunces against a clean Inter interface, and numeric or data elements use JetBrains Mono so they read distinctly as data rather than prose.
The API this consumes lives at FridgeRaidAPI — a Laravel backend with token auth and a graph-based ingredient substitution engine.