# josephamuasi001/urban-bites architecture

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

- Interactive diagram: https://gitdiagram.com/josephamuasi001/urban-bites
- Repository: https://github.com/josephamuasi001/urban-bites

## Overview

Urban Bite is a restaurant ordering product with a React frontend and FastAPI/Supabase backend. The user-facing path is restaurant discovery, restaurant/menu viewing, then cart and checkout routes; backend APIs expose restaurant, menu, order, order-item, user, and review operations. The sampled detail page and service show restaurant/menu fetching, while the cart and checkout implementations were not sampled. Frontend-to-backend endpoint matching is therefore not asserted as a direct edge.

Main entry points: [`backend/app/main.py`](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/main.py) (FastAPI app), [`frontend/src/routes/AppRoutes.jsx`](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/routes/AppRoutes.jsx) (Page routes), [`backend/app/database/supabase.py`](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/database/supabase.py) (Supabase client), [`frontend/src/pages/RestaurantDetailsPage.jsx`](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/RestaurantDetailsPage.jsx) (Restaurant details)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_web_entry["Web entry<br/>[main.jsx]"]
  node_app_routes["Page routes<br/>[AppRoutes.jsx]"]
  node_home["Home discovery<br/>[HomePage.jsx]"]
  node_restaurants_page["Restaurant browse"]
  node_restaurant_details["Restaurant details"]
  node_restaurant_ui["Restaurant display"]
  node_menu_ui["Menu display<br/>[MenuSection.jsx]"]
  node_restaurant_client["Restaurant client"]
  node_menu_client["Menu client<br/>[menuService.js]"]
  node_cart_state["Cart state<br/>[CartContext.jsx]"]
  node_cart_checkout["Cart and checkout<br/>[CartPage.jsx]"]
  node_orders_page["Order history<br/>[OrdersPage.jsx]"]
end

subgraph group_api["API routing"]
  node_backend_app["FastAPI app<br/>[main.py]"]
  node_restaurants_api["Restaurant routes<br/>[restaurants.py]"]
  node_menus_api["Menu routes<br/>[menus.py]"]
  node_orders_api["Order routes<br/>[orders.py]"]
  node_items_api["Order-item routes<br/>[order_items.py]"]
  node_reviews_api["Review routes<br/>[reviews.py]"]
end

subgraph group_identity["Identity"]
  node_users_api["User routes<br/>[users.py]"]
  node_token_guard["Token validation<br/>[auth_bearer.py]"]
  node_token_mint["Token creation<br/>[jwt_handler.py]"]
end

subgraph group_domain["Ordering domain"]
  node_restaurant_service["Restaurant service"]
  node_menu_service["Menu service<br/>[menu_service.py]"]
  node_order_service["Order service<br/>[order_service.py]"]
  node_item_service["Order-item service"]
  node_review_service["Review service<br/>[review_service.py]"]
  node_user_service["User service<br/>[user_service.py]"]
  node_supabase[("Supabase client<br/>[supabase.py]")]
end

node_shopper(("Shopper"))
node_remote_api{{"HTTP API"}}

node_shopper -->|"opens"| node_web_entry
node_web_entry -->|"renders"| node_app_routes
node_app_routes -->|"routes to"| node_home
node_app_routes -->|"routes to"| node_restaurants_page
node_app_routes -->|"routes to"| node_restaurant_details
node_app_routes -->|"routes to"| node_cart_checkout
node_app_routes -->|"routes to"| node_orders_page
node_web_entry -->|"provides"| node_cart_state
node_restaurant_details -->|"fetches via"| node_restaurant_client
node_restaurant_details -->|"fetches via"| node_menu_client
node_restaurant_details -->|"renders"| node_restaurant_ui
node_restaurant_details -->|"renders"| node_menu_ui
node_restaurant_client -->|"fetches"| node_remote_api
node_menu_client -->|"fetches"| node_remote_api
node_backend_app -->|"registers"| node_restaurants_api
node_backend_app -->|"registers"| node_menus_api
node_backend_app -->|"registers"| node_orders_api
node_backend_app -->|"registers"| node_items_api
node_backend_app -->|"registers"| node_reviews_api
node_backend_app -->|"registers"| node_users_api
node_restaurants_api -->|"calls"| node_restaurant_service
node_menus_api -->|"calls"| node_menu_service
node_orders_api -->|"calls"| node_order_service
node_items_api -->|"calls"| node_item_service
node_reviews_api -->|"calls"| node_review_service
node_users_api -->|"calls"| node_user_service
node_orders_api -->|"depends on"| node_token_guard
node_reviews_api -->|"depends on"| node_token_guard
node_users_api -->|"depends on"| node_token_guard
node_token_guard -->|"uses key"| node_token_mint
node_restaurant_service -->|"queries"| node_supabase
node_menu_service -->|"queries"| node_supabase
node_order_service -->|"reads and writes"| node_supabase
node_item_service -->|"queries"| node_supabase
node_review_service -->|"reads and writes"| node_supabase
node_user_service -->|"queries"| node_supabase

click node_web_entry "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/main.jsx"
click node_app_routes "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_home "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/HomePage.jsx"
click node_restaurants_page "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/RestaurantsPage.jsx"
click node_restaurant_details "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/RestaurantDetailsPage.jsx"
click node_restaurant_ui "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/components/RestaurantHeader.jsx"
click node_menu_ui "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/components/MenuSection.jsx"
click node_restaurant_client "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/services/restaurantService.js"
click node_menu_client "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/services/menuService.js"
click node_cart_state "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/context/CartContext.jsx"
click node_cart_checkout "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/CartPage.jsx"
click node_orders_page "https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/OrdersPage.jsx"
click node_backend_app "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/main.py"
click node_restaurants_api "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/restaurants.py"
click node_menus_api "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/menus.py"
click node_orders_api "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/orders.py"
click node_items_api "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/order_items.py"
click node_reviews_api "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/reviews.py"
click node_users_api "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/users.py"
click node_token_guard "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/auth/auth_bearer.py"
click node_token_mint "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/auth/jwt_handler.py"
click node_restaurant_service "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/restaurant_service.py"
click node_menu_service "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/menu_service.py"
click node_order_service "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/order_service.py"
click node_item_service "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/order_item_service.py"
click node_review_service "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/review_service.py"
click node_user_service "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/user_service.py"
click node_supabase "https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/database/supabase.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_web_entry,node_app_routes,node_home,node_restaurants_page,node_restaurant_details,node_restaurant_ui,node_menu_ui,node_restaurant_client,node_menu_client,node_cart_state,node_cart_checkout,node_orders_page toneBlue
class node_backend_app,node_restaurants_api,node_menus_api,node_orders_api,node_items_api,node_reviews_api toneAmber
class node_users_api,node_token_guard,node_token_mint,node_remote_api toneMint
class node_restaurant_service,node_menu_service,node_order_service,node_item_service,node_review_service,node_user_service,node_supabase toneRose
class node_shopper toneIndigo
```

## Components

### Web experience

- [Web entry](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [Page routes](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Home discovery](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [Restaurant browse](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/RestaurantsPage.jsx): `frontend/src/pages/RestaurantsPage.jsx`
- [Restaurant details](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/RestaurantDetailsPage.jsx): `frontend/src/pages/RestaurantDetailsPage.jsx`
- [Restaurant display](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/components/RestaurantHeader.jsx): `frontend/src/components/RestaurantHeader.jsx`
- [Menu display](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/components/MenuSection.jsx): `frontend/src/components/MenuSection.jsx`
- [Restaurant client](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/services/restaurantService.js): `frontend/src/services/restaurantService.js`
- [Menu client](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/services/menuService.js): `frontend/src/services/menuService.js`
- [Cart state](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/context/CartContext.jsx): `frontend/src/context/CartContext.jsx`
- [Cart and checkout](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/CartPage.jsx): `frontend/src/pages/CartPage.jsx`
- [Order history](https://github.com/josephamuasi001/urban-bites/blob/main/frontend/src/pages/OrdersPage.jsx): `frontend/src/pages/OrdersPage.jsx`

### API routing

- [FastAPI app](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/main.py): `backend/app/main.py`
- [Restaurant routes](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/restaurants.py): `backend/app/routers/restaurants.py`
- [Menu routes](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/menus.py): `backend/app/routers/menus.py`
- [Order routes](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/orders.py): `backend/app/routers/orders.py`
- [Order-item routes](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/order_items.py): `backend/app/routers/order_items.py`
- [Review routes](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/reviews.py): `backend/app/routers/reviews.py`

### Identity

- [User routes](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/routers/users.py): `backend/app/routers/users.py`
- [Token validation](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/auth/auth_bearer.py): `backend/app/auth/auth_bearer.py`
- [Token creation](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/auth/jwt_handler.py): `backend/app/auth/jwt_handler.py`

### Ordering domain

- [Restaurant service](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/restaurant_service.py): `backend/app/services/restaurant_service.py`
- [Menu service](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/menu_service.py): `backend/app/services/menu_service.py`
- [Order service](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/order_service.py): `backend/app/services/order_service.py`
- [Order-item service](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/order_item_service.py): `backend/app/services/order_item_service.py`
- [Review service](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/review_service.py): `backend/app/services/review_service.py`
- [User service](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/services/user_service.py): `backend/app/services/user_service.py`
- [Supabase client](https://github.com/josephamuasi001/urban-bites/blob/main/backend/app/database/supabase.py): `backend/app/database/supabase.py`

### Other components

- **Shopper**
- **HTTP API**

## Connections

- Shopper → Web entry: opens (evidence: `frontend/src/main.jsx`)
- Web entry → Page routes: renders
- Page routes → Home discovery: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routes → Restaurant browse: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routes → Restaurant details: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routes → Cart and checkout: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routes → Order history: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Web entry → Cart state: provides (evidence: `frontend/src/main.jsx`)
- Restaurant details → Restaurant client: fetches via (evidence: `frontend/src/pages/RestaurantDetailsPage.jsx`)
- Restaurant details → Menu client: fetches via (evidence: `frontend/src/pages/RestaurantDetailsPage.jsx`)
- Restaurant details → Restaurant display: renders (evidence: `frontend/src/pages/RestaurantDetailsPage.jsx`)
- Restaurant details → Menu display: renders (evidence: `frontend/src/pages/RestaurantDetailsPage.jsx`)
- Restaurant client → HTTP API: fetches (evidence: `frontend/src/services/restaurantService.js`)
- Menu client → HTTP API: fetches (evidence: `frontend/src/services/menuService.js`)
- FastAPI app → Restaurant routes: registers (evidence: `backend/app/main.py`)
- FastAPI app → Menu routes: registers (evidence: `backend/app/main.py`)
- FastAPI app → Order routes: registers (evidence: `backend/app/main.py`)
- FastAPI app → Order-item routes: registers (evidence: `backend/app/main.py`)
- FastAPI app → Review routes: registers (evidence: `backend/app/main.py`)
- FastAPI app → User routes: registers (evidence: `backend/app/main.py`)
- Restaurant routes → Restaurant service: calls (evidence: `backend/app/routers/restaurants.py`)
- Menu routes → Menu service: calls (evidence: `backend/app/routers/menus.py`)
- Order routes → Order service: calls (evidence: `backend/app/routers/orders.py`)
- Order-item routes → Order-item service: calls (evidence: `backend/app/routers/order_items.py`)
- Review routes → Review service: calls (evidence: `backend/app/routers/reviews.py`)
- User routes → User service: calls (evidence: `backend/app/routers/users.py`)
- Order routes → Token validation: depends on (evidence: `backend/app/routers/orders.py`)
- Review routes → Token validation: depends on (evidence: `backend/app/routers/reviews.py`)
- User routes → Token validation: depends on (evidence: `backend/app/routers/users.py`)
- Token validation → Token creation: uses key (evidence: `backend/app/auth/auth_bearer.py`)
- Restaurant service → Supabase client: queries (evidence: `backend/app/services/restaurant_service.py`)
- Menu service → Supabase client: queries (evidence: `backend/app/services/menu_service.py`)
- Order service → Supabase client: reads and writes (evidence: `backend/app/services/order_service.py`)
- Order-item service → Supabase client: queries (evidence: `backend/app/services/order_item_service.py`)
- Review service → Supabase client: reads and writes (evidence: `backend/app/services/review_service.py`)
- User service → Supabase client: queries
