# redward42/devday-2026 architecture

> Architecture diagram of the GitHub repository redward42/devday-2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/redward42/devday-2026
- Repository: https://github.com/redward42/devday-2026

## Overview

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: [`src/App.jsx`](https://github.com/RedWARd42/DevDay-2026/blob/main/src/App.jsx) (App shell), [`backend/main.py`](https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py) (HTTP API), [`src/services/api.js`](https://github.com/RedWARd42/DevDay-2026/blob/main/src/services/api.js) (API client), [`src/components/RecipeList.jsx`](https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/RecipeList.jsx) (Recipe catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Recipe browser"]
  node_app["App shell<br/>[App.jsx]"]
  node_navbar["Navigation<br/>[Navbar.jsx]"]
  node_hero["Recipe hero<br/>[Hero.jsx]"]
  node_catalog["Recipe catalog<br/>[RecipeList.jsx]"]
  node_search["Search input<br/>[SearchBar.jsx]"]
  node_card["Recipe card<br/>[RecipeCard.jsx]"]
  node_details["Recipe details<br/>[RecipeDetail.jsx]"]
  node_recipes["Recipe data<br/>[recipes.js]"]
end

subgraph group_voice["Voice cooking assistant"]
  node_voiceui["Voice interface<br/>[VoiceAssistant.jsx]"]
  node_transcription["Speech transcription<br/>[main.py]"]
  node_chefreply["Chef response<br/>[main.py]"]
  node_speech["Speech synthesis<br/>[main.py]"]
end

subgraph group_favorites["Favorite recipes"]
  node_favstate["Favorites state"]
  node_favstore[("Favorites storage")]
end

subgraph group_backend["Backend services"]
  node_api["API client<br/>[api.js]"]
  node_fastapi["HTTP API<br/>[main.py]"]
end

node_cook(("User"))
node_eleven["ElevenLabs"]
node_gemini["Gemini"]
node_firestore[("Firestore")]

node_cook -->|"uses"| node_app
node_app -->|"renders"| node_navbar
node_app -->|"renders"| node_hero
node_app -->|"renders"| node_catalog
node_app -->|"renders"| node_details
node_app -->|"renders"| node_voiceui
node_app -->|"filters"| node_recipes
node_catalog -->|"renders"| node_search
node_catalog -->|"renders"| node_card
node_card -->|"toggles"| node_favstate
node_cook -->|"records question"| node_voiceui
node_voiceui -->|"sends recording"| node_api
node_api -->|"posts voice audio"| node_fastapi
node_fastapi -->|"calls"| node_transcription
node_transcription -->|"transcribes via"| node_eleven
node_fastapi -->|"calls"| node_chefreply
node_chefreply -->|"generates reply via"| node_gemini
node_fastapi -->|"calls"| node_speech
node_speech -->|"synthesizes via"| node_eleven
node_favstate -->|"requests favorites"| node_api
node_api -->|"requests favorites"| node_fastapi
node_fastapi -->|"reads and toggles"| node_favstore
node_favstore -->|"reads and writes"| node_firestore

click node_app "https://github.com/RedWARd42/DevDay-2026/blob/main/src/App.jsx"
click node_navbar "https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/Navbar.jsx"
click node_hero "https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/Hero.jsx"
click node_catalog "https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/RecipeList.jsx"
click node_search "https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/SearchBar.jsx"
click node_card "https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/RecipeCard.jsx"
click node_details "https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/RecipeDetail.jsx"
click node_recipes "https://github.com/RedWARd42/DevDay-2026/blob/main/src/data/recipes.js"
click node_voiceui "https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/VoiceAssistant.jsx"
click node_api "https://github.com/RedWARd42/DevDay-2026/blob/main/src/services/api.js"
click node_favstate "https://github.com/RedWARd42/DevDay-2026/blob/main/src/context/FavoritesContext.jsx"
click node_fastapi "https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py"
click node_transcription "https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py"
click node_chefreply "https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py"
click node_speech "https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py"
click node_favstore "https://github.com/RedWARd42/DevDay-2026/blob/main/backend/firebase_service.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_navbar,node_hero,node_catalog,node_search,node_card,node_details,node_recipes,node_cook toneBlue
class node_voiceui,node_transcription,node_chefreply,node_speech,node_firestore toneAmber
class node_favstate,node_favstore toneMint
class node_api,node_fastapi toneRose
class node_eleven,node_gemini toneIndigo
```

## Components

### Recipe browser

- [App shell](https://github.com/RedWARd42/DevDay-2026/blob/main/src/App.jsx): `src/App.jsx`
- [Navigation](https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/Navbar.jsx): `src/components/Navbar.jsx`
- [Recipe hero](https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/Hero.jsx): `src/components/Hero.jsx`
- [Recipe catalog](https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/RecipeList.jsx): `src/components/RecipeList.jsx`
- [Search input](https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/SearchBar.jsx): `src/components/SearchBar.jsx`
- [Recipe card](https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/RecipeCard.jsx): `src/components/RecipeCard.jsx`
- [Recipe details](https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/RecipeDetail.jsx): `src/components/RecipeDetail.jsx`
- [Recipe data](https://github.com/RedWARd42/DevDay-2026/blob/main/src/data/recipes.js): `src/data/recipes.js`

### Voice cooking assistant

- [Voice interface](https://github.com/RedWARd42/DevDay-2026/blob/main/src/components/VoiceAssistant.jsx): `src/components/VoiceAssistant.jsx`
- [Speech transcription](https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py): `backend/main.py`
- [Chef response](https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py): `backend/main.py`
- [Speech synthesis](https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py): `backend/main.py`

### Favorite recipes

- [Favorites state](https://github.com/RedWARd42/DevDay-2026/blob/main/src/context/FavoritesContext.jsx): `src/context/FavoritesContext.jsx`
- [Favorites storage](https://github.com/RedWARd42/DevDay-2026/blob/main/backend/firebase_service.py): `backend/firebase_service.py`

### Backend services

- [API client](https://github.com/RedWARd42/DevDay-2026/blob/main/src/services/api.js): `src/services/api.js`
- [HTTP API](https://github.com/RedWARd42/DevDay-2026/blob/main/backend/main.py): `backend/main.py`

### Other components

- **User**
- **ElevenLabs**
- **Gemini**
- **Firestore**

## Connections

- User → App shell: uses (evidence: `src/App.jsx`)
- App shell → Navigation: renders (evidence: `src/App.jsx`)
- App shell → Recipe hero: renders (evidence: `src/App.jsx`)
- App shell → Recipe catalog: renders (evidence: `src/App.jsx`)
- App shell → Recipe details: renders (evidence: `src/App.jsx`)
- App shell → Voice interface: renders (evidence: `src/App.jsx`)
- App shell → Recipe data: filters (evidence: `src/App.jsx`)
- Recipe catalog → Search input: renders (evidence: `src/components/RecipeList.jsx`)
- Recipe catalog → Recipe card: renders (evidence: `src/components/RecipeList.jsx`)
- Recipe card → Favorites state: toggles (evidence: `src/components/RecipeCard.jsx`)
- User → Voice interface: records question (evidence: `src/components/VoiceAssistant.jsx`)
- Voice interface → API client: sends recording (evidence: `src/components/VoiceAssistant.jsx`)
- API client → HTTP API: posts voice audio (evidence: `src/services/api.js`)
- HTTP API → Speech transcription: calls (evidence: `backend/main.py`)
- Speech transcription → ElevenLabs: transcribes via (evidence: `backend/main.py`)
- HTTP API → Chef response: calls (evidence: `backend/main.py`)
- Chef response → Gemini: generates reply via (evidence: `backend/main.py`)
- HTTP API → Speech synthesis: calls (evidence: `backend/main.py`)
- Speech synthesis → ElevenLabs: synthesizes via (evidence: `backend/main.py`)
- Favorites state → API client: requests favorites (evidence: `src/context/FavoritesContext.jsx`)
- API client → HTTP API: requests favorites (evidence: `src/services/api.js`)
- HTTP API → Favorites storage: reads and toggles (evidence: `backend/main.py`)
- Favorites storage → Firestore: reads and writes (evidence: `backend/firebase_service.py`)
