How redward42/devday-2026 works
DevDay Recipes is a React recipe browser with a FastAPI backend for favorites and a spoken cooking assistant. Users search the bundled recipes, open a recipe, and can toggle favorites; the voice path records a question, sends it for transcription, generates a chef-style answer, converts it to speech, and plays the audio. Favorites are keyed by a locally generated user ID and persisted in Firestore. README identifies this as a workshop starter, so product capabilities are based chiefly on the sampled implementation; unsampled UI components are included from the source index.
Main entry points: App.jsx App shell · main.py HTTP API · api.js API client · RecipeList.jsx Recipe catalog
Components 20
Recipe browser
- App shell
src/App.jsx - Navigation
src/components/Navbar.jsx - Recipe hero
src/components/Hero.jsx - Recipe catalog
src/components/RecipeList.jsx - Search input
src/components/SearchBar.jsx - Recipe card
src/components/RecipeCard.jsx - Recipe details
src/components/RecipeDetail.jsx - Recipe data
src/data/recipes.js
Voice cooking assistant
- Voice interface
src/components/VoiceAssistant.jsx - Speech transcription
backend/main.py - Chef response
backend/main.py - Speech synthesis
backend/main.py
Favorite recipes
- Favorites state
src/context/FavoritesContext.jsx - Favorites storage
backend/firebase_service.py
Backend services
- API client
src/services/api.js - HTTP API
backend/main.py
Other components
- User
- ElevenLabs
- Gemini
- Firestore
Connections 23
- User → App shell: uses
src/App.jsx - App shell → Navigation: renders
src/App.jsx - App shell → Recipe hero: renders
src/App.jsx - App shell → Recipe catalog: renders
src/App.jsx - App shell → Recipe details: renders
src/App.jsx - App shell → Voice interface: renders
src/App.jsx - App shell → Recipe data: filters
src/App.jsx - Recipe catalog → Search input: renders
src/components/RecipeList.jsx - Recipe catalog → Recipe card: renders
src/components/RecipeList.jsx - Recipe card → Favorites state: toggles
src/components/RecipeCard.jsx - User → Voice interface: records question
src/components/VoiceAssistant.jsx - Voice interface → API client: sends recording
src/components/VoiceAssistant.jsx - API client → HTTP API: posts voice audio
src/services/api.js - HTTP API → Speech transcription: calls
backend/main.py - Speech transcription → ElevenLabs: transcribes via
backend/main.py - HTTP API → Chef response: calls
backend/main.py - Chef response → Gemini: generates reply via
backend/main.py - HTTP API → Speech synthesis: calls
backend/main.py - Speech synthesis → ElevenLabs: synthesizes via
backend/main.py - Favorites state → API client: requests favorites
src/context/FavoritesContext.jsx - API client → HTTP API: requests favorites
src/services/api.js - HTTP API → Favorites storage: reads and toggles
backend/main.py - Favorites storage → Firestore: reads and writes
backend/firebase_service.py