# nitheshacharya/urban_roots architecture

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

- Interactive diagram: https://gitdiagram.com/nitheshacharya/urban_roots
- Repository: https://github.com/nitheshacharya/urban_roots

## Overview

UrbanRoots is an urban-gardening application with plant reference and care tools, community and commerce features, expert booking, and AI-assisted utilities. The browser workflow starts at the React app’s routed pages; users can browse plant information, manage growing activity, or use marketplace and community features, with selected operations backed by Supabase and API routes. The source index identifies additional server capabilities, but their implementation details were not excerpted, so those connections are limited to documented imports. The README is only the default Vite template and does not document product behavior.

Main entry points: [`src/App.jsx`](https://github.com/nitheshacharya/urban_roots/blob/main/src/App.jsx) (React app), [`src/utils/supabase.js`](https://github.com/nitheshacharya/urban_roots/blob/main/src/utils/supabase.js) (Supabase client), [`api/_utils.js`](https://github.com/nitheshacharya/urban_roots/blob/main/api/_utils.js) (API shared utilities), [`src/utils/gamification.js`](https://github.com/nitheshacharya/urban_roots/blob/main/src/utils/gamification.js) (Gamification)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Web application"]
  node_app["React app<br/>[App.jsx]"]
  node_layout["App layout<br/>[Layout.jsx]"]
  node_auth["Authentication<br/>[Auth.jsx]"]
  node_auth_state["Auth state<br/>[AuthContext.jsx]"]
  node_cart_state["Cart state<br/>[CartContext.jsx]"]
  node_theme_state["Theme state<br/>[ThemeContext.jsx]"]
  node_service_worker["PWA service worker<br/>[sw.js]"]
end

subgraph group_gardening["Gardening tools"]
  node_dashboard["Gardening dashboard<br/>[Dashboard.jsx]"]
  node_encyclopedia["Plant encyclopedia<br/>[Encyclopedia.jsx]"]
  node_plant_details["Plant details<br/>[PlantDetails.jsx]"]
  node_plant_data["Plant catalog data<br/>[plantsData.js]"]
  node_calendar["Planting calendar"]
  node_yield["Yield calculator"]
  node_ai_tools["AI gardening tools<br/>[AITools.jsx]"]
  node_gamification["Gamification<br/>[gamification.js]"]
end

subgraph group_community["Community and commerce"]
  node_community_page["Community<br/>[Community.jsx]"]
  node_market["Marketplace<br/>[Marketplace.jsx]"]
  node_checkout["Checkout<br/>[Checkout.jsx]"]
  node_experts["Expert booking<br/>[Experts.jsx]"]
  node_nurseries["Nurseries<br/>[Nurseries.jsx]"]
  node_profile["Gardener profile<br/>[Profile.jsx]"]
end

subgraph group_services["Backend services"]
  node_supabase_client["Supabase client<br/>[supabase.js]"]
  node_supabase[("Supabase")]
  node_api_utils["API shared utilities<br/>[_utils.js]"]
  node_plant_analysis["Plant analysis API<br/>[analyze-plant.js]"]
  node_recipe_api["Recipe generation API"]
  node_chat_api["Chat API<br/>[chat.js]"]
  node_chat_history["Chat history API<br/>[&#91;userId&#93;.js]"]
  node_watering_api["Watering API<br/>[water.js]"]
  node_reminders_api["Water reminders<br/>[water-reminder.js]"]
  node_push_api["Push subscription API<br/>[subscribe.js]"]
end

node_gardener(("Gardener"))
node_gemini{{"Gemini API"}}
node_resend{{"Resend email"}}

node_gardener -->|"opens"| node_app
node_app -->|"routes to"| node_auth
node_app -->|"routes to"| node_layout
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_encyclopedia
node_app -->|"routes to"| node_plant_details
node_app -->|"routes to"| node_calendar
node_app -->|"routes to"| node_yield
node_app -->|"routes to"| node_ai_tools
node_app -->|"routes to"| node_community_page
node_app -->|"routes to"| node_market
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_experts
node_app -->|"routes to"| node_nurseries
node_app -->|"routes to"| node_profile
node_auth -->|"uses"| node_auth_state
node_auth_state -->|"queries"| node_supabase_client
node_supabase_client -->|"connects to"| node_supabase
node_layout -->|"queries"| node_supabase_client
node_layout -.->|"renders navigation"| node_gardener
node_encyclopedia -->|"reads catalog"| node_plant_data
node_plant_details -->|"reads catalog"| node_plant_data
node_dashboard -->|"reads catalog"| node_plant_data
node_calendar -->|"reads catalog"| node_plant_data
node_yield -->|"reads catalog"| node_plant_data
node_dashboard -->|"queries"| node_supabase_client
node_community_page -->|"queries"| node_supabase_client
node_market -->|"queries"| node_supabase_client
node_profile -->|"queries"| node_supabase_client
node_plant_details -->|"queries"| node_supabase_client
node_ai_tools -->|"queries"| node_supabase_client
node_market -->|"uses cart"| node_cart_state
node_checkout -->|"uses cart"| node_cart_state
node_plant_details -->|"awards progress"| node_gamification
node_dashboard -->|"uses progress"| node_gamification
node_profile -->|"uses progress"| node_gamification
node_yield -->|"uses progress"| node_gamification
node_gamification -->|"reads and writes"| node_supabase_client
node_app -->|"registers"| node_service_worker
node_plant_analysis -->|"imports utilities"| node_api_utils
node_recipe_api -->|"imports utilities"| node_api_utils
node_chat_api -->|"imports utilities"| node_api_utils
node_chat_history -->|"imports utilities"| node_api_utils
node_watering_api -->|"imports utilities"| node_api_utils
node_reminders_api -->|"imports utilities"| node_api_utils
node_push_api -->|"imports utilities"| node_api_utils
node_api_utils -->|"creates client"| node_supabase
node_api_utils -->|"configures endpoint"| node_gemini

click node_app "https://github.com/nitheshacharya/urban_roots/blob/main/src/App.jsx"
click node_layout "https://github.com/nitheshacharya/urban_roots/blob/main/src/components/Layout.jsx"
click node_auth "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Auth.jsx"
click node_auth_state "https://github.com/nitheshacharya/urban_roots/blob/main/src/context/AuthContext.jsx"
click node_cart_state "https://github.com/nitheshacharya/urban_roots/blob/main/src/context/CartContext.jsx"
click node_theme_state "https://github.com/nitheshacharya/urban_roots/blob/main/src/context/ThemeContext.jsx"
click node_supabase_client "https://github.com/nitheshacharya/urban_roots/blob/main/src/utils/supabase.js"
click node_dashboard "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Dashboard.jsx"
click node_encyclopedia "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Encyclopedia.jsx"
click node_plant_details "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/PlantDetails.jsx"
click node_plant_data "https://github.com/nitheshacharya/urban_roots/blob/main/src/data/plantsData.js"
click node_calendar "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/PlantingCalendar.jsx"
click node_yield "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/YieldCalculator.jsx"
click node_ai_tools "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/AITools.jsx"
click node_community_page "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Community.jsx"
click node_market "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Marketplace.jsx"
click node_checkout "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Checkout.jsx"
click node_experts "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Experts.jsx"
click node_nurseries "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Nurseries.jsx"
click node_profile "https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Profile.jsx"
click node_gamification "https://github.com/nitheshacharya/urban_roots/blob/main/src/utils/gamification.js"
click node_api_utils "https://github.com/nitheshacharya/urban_roots/blob/main/api/_utils.js"
click node_plant_analysis "https://github.com/nitheshacharya/urban_roots/blob/main/api/analyze-plant.js"
click node_recipe_api "https://github.com/nitheshacharya/urban_roots/blob/main/api/generate-recipes.js"
click node_chat_api "https://github.com/nitheshacharya/urban_roots/blob/main/api/chat.js"
click node_chat_history "https://github.com/nitheshacharya/urban_roots/blob/main/api/chat-history/%5BuserId%5D.js"
click node_watering_api "https://github.com/nitheshacharya/urban_roots/blob/main/api/plants/%5Bid%5D/water.js"
click node_reminders_api "https://github.com/nitheshacharya/urban_roots/blob/main/api/cron/water-reminder.js"
click node_push_api "https://github.com/nitheshacharya/urban_roots/blob/main/api/push/subscribe.js"
click node_service_worker "https://github.com/nitheshacharya/urban_roots/blob/main/public/sw.js"

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_layout,node_auth,node_auth_state,node_cart_state,node_theme_state,node_service_worker toneBlue
class node_dashboard,node_encyclopedia,node_plant_details,node_plant_data,node_calendar,node_yield,node_ai_tools,node_gamification toneAmber
class node_community_page,node_market,node_checkout,node_experts,node_nurseries,node_profile,node_gemini toneMint
class node_supabase_client,node_supabase,node_api_utils,node_plant_analysis,node_recipe_api,node_chat_api,node_chat_history,node_watering_api,node_reminders_api,node_push_api toneRose
class node_gardener,node_resend toneIndigo
```

## Components

### Web application

- [React app](https://github.com/nitheshacharya/urban_roots/blob/main/src/App.jsx): `src/App.jsx`
- [App layout](https://github.com/nitheshacharya/urban_roots/blob/main/src/components/Layout.jsx): `src/components/Layout.jsx`
- [Authentication](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Auth.jsx): `src/pages/Auth.jsx`
- [Auth state](https://github.com/nitheshacharya/urban_roots/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Cart state](https://github.com/nitheshacharya/urban_roots/blob/main/src/context/CartContext.jsx): `src/context/CartContext.jsx`
- [Theme state](https://github.com/nitheshacharya/urban_roots/blob/main/src/context/ThemeContext.jsx): `src/context/ThemeContext.jsx`
- [PWA service worker](https://github.com/nitheshacharya/urban_roots/blob/main/public/sw.js): `public/sw.js`

### Gardening tools

- [Gardening dashboard](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Plant encyclopedia](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Encyclopedia.jsx): `src/pages/Encyclopedia.jsx`
- [Plant details](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/PlantDetails.jsx): `src/pages/PlantDetails.jsx`
- [Plant catalog data](https://github.com/nitheshacharya/urban_roots/blob/main/src/data/plantsData.js): `src/data/plantsData.js`
- [Planting calendar](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/PlantingCalendar.jsx): `src/pages/PlantingCalendar.jsx`
- [Yield calculator](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/YieldCalculator.jsx): `src/pages/YieldCalculator.jsx`
- [AI gardening tools](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/AITools.jsx): `src/pages/AITools.jsx`
- [Gamification](https://github.com/nitheshacharya/urban_roots/blob/main/src/utils/gamification.js): `src/utils/gamification.js`

### Community and commerce

- [Community](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Community.jsx): `src/pages/Community.jsx`
- [Marketplace](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Marketplace.jsx): `src/pages/Marketplace.jsx`
- [Checkout](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Checkout.jsx): `src/pages/Checkout.jsx`
- [Expert booking](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Experts.jsx): `src/pages/Experts.jsx`
- [Nurseries](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Nurseries.jsx): `src/pages/Nurseries.jsx`
- [Gardener profile](https://github.com/nitheshacharya/urban_roots/blob/main/src/pages/Profile.jsx): `src/pages/Profile.jsx`

### Backend services

- [Supabase client](https://github.com/nitheshacharya/urban_roots/blob/main/src/utils/supabase.js): `src/utils/supabase.js`
- **Supabase**
- [API shared utilities](https://github.com/nitheshacharya/urban_roots/blob/main/api/_utils.js): `api/_utils.js`
- [Plant analysis API](https://github.com/nitheshacharya/urban_roots/blob/main/api/analyze-plant.js): `api/analyze-plant.js`
- [Recipe generation API](https://github.com/nitheshacharya/urban_roots/blob/main/api/generate-recipes.js): `api/generate-recipes.js`
- [Chat API](https://github.com/nitheshacharya/urban_roots/blob/main/api/chat.js): `api/chat.js`
- [Chat history API](https://github.com/nitheshacharya/urban_roots/blob/main/api/chat-history/%5BuserId%5D.js): `api/chat-history/[userId].js`
- [Watering API](https://github.com/nitheshacharya/urban_roots/blob/main/api/plants/%5Bid%5D/water.js): `api/plants/[id]/water.js`
- [Water reminders](https://github.com/nitheshacharya/urban_roots/blob/main/api/cron/water-reminder.js): `api/cron/water-reminder.js`
- [Push subscription API](https://github.com/nitheshacharya/urban_roots/blob/main/api/push/subscribe.js): `api/push/subscribe.js`

### Other components

- **Gardener**
- **Gemini API**
- **Resend email**

## Connections

- Gardener → React app: opens
- React app → Authentication: routes to (evidence: `src/App.jsx`)
- React app → App layout: routes to (evidence: `src/App.jsx`)
- React app → Gardening dashboard: routes to (evidence: `src/App.jsx`)
- React app → Plant encyclopedia: routes to (evidence: `src/App.jsx`)
- React app → Plant details: routes to (evidence: `src/App.jsx`)
- React app → Planting calendar: routes to (evidence: `src/App.jsx`)
- React app → Yield calculator: routes to (evidence: `src/App.jsx`)
- React app → AI gardening tools: routes to (evidence: `src/App.jsx`)
- React app → Community: routes to (evidence: `src/App.jsx`)
- React app → Marketplace: routes to (evidence: `src/App.jsx`)
- React app → Checkout: routes to (evidence: `src/App.jsx`)
- React app → Expert booking: routes to (evidence: `src/App.jsx`)
- React app → Nurseries: routes to (evidence: `src/App.jsx`)
- React app → Gardener profile: routes to (evidence: `src/App.jsx`)
- Authentication → Auth state: uses (evidence: `src/pages/Auth.jsx`)
- Auth state → Supabase client: queries (evidence: `src/context/AuthContext.jsx`)
- Supabase client → Supabase: connects to (evidence: `src/utils/supabase.js`)
- App layout → Supabase client: queries (evidence: `src/components/Layout.jsx`)
- App layout → Gardener: renders navigation
- Plant encyclopedia → Plant catalog data: reads catalog (evidence: `src/pages/Encyclopedia.jsx`)
- Plant details → Plant catalog data: reads catalog (evidence: `src/pages/PlantDetails.jsx`)
- Gardening dashboard → Plant catalog data: reads catalog (evidence: `src/pages/Dashboard.jsx`)
- Planting calendar → Plant catalog data: reads catalog (evidence: `src/pages/PlantingCalendar.jsx`)
- Yield calculator → Plant catalog data: reads catalog (evidence: `src/pages/YieldCalculator.jsx`)
- Gardening dashboard → Supabase client: queries (evidence: `src/pages/Dashboard.jsx`)
- Community → Supabase client: queries (evidence: `src/pages/Community.jsx`)
- Marketplace → Supabase client: queries (evidence: `src/pages/Marketplace.jsx`)
- Gardener profile → Supabase client: queries (evidence: `src/pages/Profile.jsx`)
- Plant details → Supabase client: queries (evidence: `src/pages/PlantDetails.jsx`)
- AI gardening tools → Supabase client: queries (evidence: `src/pages/AITools.jsx`)
- Marketplace → Cart state: uses cart (evidence: `src/pages/Marketplace.jsx`)
- Checkout → Cart state: uses cart (evidence: `src/pages/Checkout.jsx`)
- Plant details → Gamification: awards progress (evidence: `src/pages/PlantDetails.jsx`)
- Gardening dashboard → Gamification: uses progress (evidence: `src/pages/Dashboard.jsx`)
- Gardener profile → Gamification: uses progress (evidence: `src/pages/Profile.jsx`)
- Yield calculator → Gamification: uses progress (evidence: `src/pages/YieldCalculator.jsx`)
- Gamification → Supabase client: reads and writes (evidence: `src/utils/gamification.js`)
- React app → PWA service worker: registers
- Plant analysis API → API shared utilities: imports utilities (evidence: `api/analyze-plant.js`)
- Recipe generation API → API shared utilities: imports utilities (evidence: `api/generate-recipes.js`)
- Chat API → API shared utilities: imports utilities (evidence: `api/chat.js`)
- Chat history API → API shared utilities: imports utilities (evidence: `api/chat-history/[userId].js`)
- Watering API → API shared utilities: imports utilities (evidence: `api/plants/[id]/water.js`)
- Water reminders → API shared utilities: imports utilities (evidence: `api/cron/water-reminder.js`)
- Push subscription API → API shared utilities: imports utilities (evidence: `api/push/subscribe.js`)
- API shared utilities → Supabase: creates client (evidence: `api/_utils.js`)
- API shared utilities → Gemini API: configures endpoint (evidence: `api/_utils.js`)
