How akash030605/fridgeos works
FridgeOS turns a fridge photo into editable ingredients and tailored recipes, with universal recipe discovery and a persistent shopping list. The React app coordinates the user workflow; Express endpoints validate requests and use Gemini for image analysis and recipe generation. The README documents UI and search behavior not fully visible in the excerpts, so those relationships are cited to it; backend calls and validation links are shown in sampled route code.
Main entry points: App.tsx App coordinator · analyze.ts Fridge analysis · recipes.ts Recipe discovery · IngredientsState.tsx Ingredient editor
Components 21
Web experience
- App coordinator
src/App.tsx - Hero screen
src/components/Hero.tsx - Global navigation
src/components/Navbar.tsx
Fridge workflow
- Photo upload
src/components/UploadState.tsx - Ingredient editor
src/components/IngredientsState.tsx - Scan feedback
src/components/ScanOverlay.tsx - Ingredient skeletons
src/components/SkeletonChip.tsx - Loading messages
src/components/RotatingText.tsx - Recipe workspace
src/components/RecipesState.tsx - Recipe skeletons
src/components/SkeletonRecipeCard.tsx - Shopping list
src/App.tsx
API services
- API app
src/apiApp.ts - Fridge analysis
src/routes/analyze.ts - Tailored recipes
src/routes/recipes.ts - Recipe discovery
src/routes/recipes.ts
AI and validation
- Gemini client
src/lib/gemini.ts - AI prompts
src/lib/prompts.ts - Request and output schemas
src/lib/schemas.ts - Rate limits
src/lib/rateLimits.ts
Other components
- Home cook
- Google Gemini
Connections 33
- Home cook → App coordinator: uses
README.md - App coordinator → Hero screen: renders
src/App.tsx - App coordinator → Global navigation: renders
src/App.tsx - App coordinator → Photo upload: renders
src/App.tsx - App coordinator → Ingredient editor: renders
src/App.tsx - App coordinator → Recipe workspace: renders
src/App.tsx - Photo upload → Fridge analysis: uploads photo
README.md - Ingredient editor → Fridge analysis: requests scan
README.md - Ingredient editor → Scan feedback: renders
src/components/IngredientsState.tsx - Ingredient editor → Ingredient skeletons: renders
src/components/IngredientsState.tsx - Ingredient editor → Loading messages: renders
src/components/IngredientsState.tsx - App coordinator → Tailored recipes: requests recipes
src/App.tsx - App coordinator → Shopping list: persists list
src/App.tsx - Global navigation → Recipe discovery: submits query
README.md - Recipe workspace → Recipe discovery: searches globally
README.md - Recipe workspace → Recipe skeletons: renders
src/components/RecipesState.tsx - Recipe workspace → Loading messages: renders
src/components/RecipesState.tsx - API app → Fridge analysis: routes requests
src/apiApp.ts - API app → Tailored recipes: routes requests
src/apiApp.ts - API app → Recipe discovery: routes requests
src/apiApp.ts - Fridge analysis → Rate limits: uses limiter
src/routes/analyze.ts - Tailored recipes → Rate limits: uses limiter
src/routes/recipes.ts - Recipe discovery → Rate limits: uses limiter
src/routes/recipes.ts - Fridge analysis → AI prompts: uses prompts
src/routes/analyze.ts - Fridge analysis → Request and output schemas: validates output
src/routes/analyze.ts - Fridge analysis → Gemini client: calls
src/routes/analyze.ts - Tailored recipes → AI prompts: builds prompt
src/routes/recipes.ts - Tailored recipes → Request and output schemas: validates input and output
src/routes/recipes.ts - Tailored recipes → Gemini client: calls
src/routes/recipes.ts - Recipe discovery → AI prompts: builds prompt
src/routes/recipes.ts - Recipe discovery → Request and output schemas: validates input and output
src/routes/recipes.ts - Recipe discovery → Gemini client: calls
src/routes/recipes.ts - Gemini client → Google Gemini: generates output