# wineithinzar41-lang/recycle-discovery-platform architecture

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

- Interactive diagram: https://gitdiagram.com/wineithinzar41-lang/recycle-discovery-platform
- Repository: https://github.com/wineithinzar41-lang/recycle-discovery-platform

## Overview

RE:CYCLE is a bilingual recycling-education web application. Users browse materials and recycled-product examples, explore recycling processes and impacts, take a quiz, and save favorites; global search helps find content across the catalog. The graph preserves these domain areas and the shared localization, search, and preference layers. Route wiring and several shared-data calls are evidenced by excerpts or the source index; unsampled page internals are shown without speculative connections.

Main entry points: [`src/App.tsx`](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/App.tsx) (Route application), [`src/hooks/useLocalizedData.ts`](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/hooks/useLocalizedData.ts) (Localized content access), [`src/pages/ProcessPage.tsx`](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/ProcessPage.tsx) (Process explorer), [`src/utils/search.ts`](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/utils/search.ts) (Cross-content search)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_routes["Route application<br/>[App.tsx]"]
  node_layout["Shared layout<br/>[AppLayout.tsx]"]
end

subgraph group_learn["Recycling education"]
  node_home["Home page<br/>[HomePage.tsx]"]
  node_materials["Materials catalog<br/>[MaterialsPage.tsx]"]
  node_materialdetail["Material details"]
  node_products["Product catalog<br/>[ProductsPage.tsx]"]
  node_process["Process explorer<br/>[ProcessPage.tsx]"]
  node_journey["Journey explorer"]
  node_timeline["Process timeline"]
  node_impact["Impact education<br/>[ImpactPage.tsx]"]
  node_quiz["Recycling quiz<br/>[QuizPage.tsx]"]
  node_favorites["Saved favorites<br/>[FavoritesPage.tsx]"]
end

subgraph group_content["Content and localization"]
  node_materialsdata["Material records<br/>[materials.ts]"]
  node_productdata["Product records<br/>[index.ts]"]
  node_productexpansion["Expanded products<br/>[expansion.ts]"]
  node_processdata["Process records<br/>[process.ts]"]
  node_localdata["Localized content access"]
  node_translations["Translation resources<br/>[process.ts]"]
end

subgraph group_shared["Shared features"]
  node_language["Language provider"]
  node_searchdialog["Global search dialog<br/>[SearchDialog.tsx]"]
  node_search["Cross-content search<br/>[search.ts]"]
  node_searchstate["Search state<br/>[SearchContext.tsx]"]
  node_favoritesstate["Favorites state"]
  node_storage["Browser storage hook<br/>[useLocalStorage.ts]"]
end

node_visitor(("Site visitor"))

node_visitor -->|"opens"| node_routes
node_routes -->|"wraps routes"| node_layout
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_materials
node_routes -->|"routes to"| node_materialdetail
node_routes -->|"routes to"| node_products
node_routes -->|"routes to"| node_process
node_routes -->|"routes to"| node_impact
node_routes -->|"routes to"| node_quiz
node_routes -->|"routes to"| node_favorites
node_layout -->|"renders"| node_searchdialog
node_process -->|"renders"| node_journey
node_process -->|"renders"| node_timeline
node_process -->|"loads localized data"| node_localdata
node_impact -->|"loads localized data"| node_localdata
node_quiz -->|"loads quiz content"| node_localdata
node_localdata -->|"localizes"| node_materialsdata
node_localdata -->|"localizes"| node_productdata
node_localdata -->|"localizes"| node_processdata
node_localdata -->|"uses translations"| node_translations
node_productdata -->|"assembles records"| node_productexpansion
node_searchdialog -->|"queries"| node_search
node_searchdialog -->|"uses search state"| node_searchstate
node_search -->|"searches"| node_materialsdata
node_search -->|"searches"| node_productdata
node_search -->|"searches"| node_processdata
node_favoritesstate -->|"persists through"| node_storage
node_routes -->|"provides language"| node_language

click node_routes "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/App.tsx"
click node_layout "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/layouts/AppLayout.tsx"
click node_home "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/HomePage.tsx"
click node_materials "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/MaterialsPage.tsx"
click node_materialdetail "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/MaterialDetailPage.tsx"
click node_products "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/ProductsPage.tsx"
click node_process "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/ProcessPage.tsx"
click node_journey "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/components/process/JourneyExplorer.tsx"
click node_timeline "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/components/process/ProcessTimeline.tsx"
click node_impact "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/ImpactPage.tsx"
click node_quiz "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/QuizPage.tsx"
click node_favorites "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/FavoritesPage.tsx"
click node_materialsdata "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/data/materials.ts"
click node_productdata "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/data/products/index.ts"
click node_productexpansion "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/data/products/expansion.ts"
click node_processdata "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/data/process.ts"
click node_localdata "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/hooks/useLocalizedData.ts"
click node_translations "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/i18n/content/process.ts"
click node_language "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/i18n/LanguageProvider.tsx"
click node_searchdialog "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/components/layout/SearchDialog.tsx"
click node_search "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/utils/search.ts"
click node_searchstate "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/context/SearchContext.tsx"
click node_favoritesstate "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/context/FavoritesContext.tsx"
click node_storage "https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/hooks/useLocalStorage.ts"

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_routes,node_layout toneBlue
class node_home,node_materials,node_materialdetail,node_products,node_process,node_journey,node_timeline,node_impact,node_quiz,node_favorites toneAmber
class node_materialsdata,node_productdata,node_productexpansion,node_processdata,node_localdata,node_translations toneMint
class node_language,node_searchdialog,node_search,node_searchstate,node_favoritesstate,node_storage toneRose
class node_visitor toneIndigo
```

## Components

### Application shell

- [Route application](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/App.tsx): `src/App.tsx`
- [Shared layout](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/layouts/AppLayout.tsx): `src/layouts/AppLayout.tsx`

### Recycling education

- [Home page](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/HomePage.tsx): `src/pages/HomePage.tsx`
- [Materials catalog](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/MaterialsPage.tsx): `src/pages/MaterialsPage.tsx`
- [Material details](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/MaterialDetailPage.tsx): `src/pages/MaterialDetailPage.tsx`
- [Product catalog](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/ProductsPage.tsx): `src/pages/ProductsPage.tsx`
- [Process explorer](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/ProcessPage.tsx): `src/pages/ProcessPage.tsx`
- [Journey explorer](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/components/process/JourneyExplorer.tsx): `src/components/process/JourneyExplorer.tsx`
- [Process timeline](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/components/process/ProcessTimeline.tsx): `src/components/process/ProcessTimeline.tsx`
- [Impact education](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/ImpactPage.tsx): `src/pages/ImpactPage.tsx`
- [Recycling quiz](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/QuizPage.tsx): `src/pages/QuizPage.tsx`
- [Saved favorites](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/pages/FavoritesPage.tsx): `src/pages/FavoritesPage.tsx`

### Content and localization

- [Material records](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/data/materials.ts): `src/data/materials.ts`
- [Product records](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/data/products/index.ts): `src/data/products/index.ts`
- [Expanded products](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/data/products/expansion.ts): `src/data/products/expansion.ts`
- [Process records](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/data/process.ts): `src/data/process.ts`
- [Localized content access](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/hooks/useLocalizedData.ts): `src/hooks/useLocalizedData.ts`
- [Translation resources](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/i18n/content/process.ts): `src/i18n/content/process.ts`

### Shared features

- [Language provider](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/i18n/LanguageProvider.tsx): `src/i18n/LanguageProvider.tsx`
- [Global search dialog](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/components/layout/SearchDialog.tsx): `src/components/layout/SearchDialog.tsx`
- [Cross-content search](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/utils/search.ts): `src/utils/search.ts`
- [Search state](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/context/SearchContext.tsx): `src/context/SearchContext.tsx`
- [Favorites state](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/context/FavoritesContext.tsx): `src/context/FavoritesContext.tsx`
- [Browser storage hook](https://github.com/wineithinzar41-lang/recycle-discovery-platform/blob/main/src/hooks/useLocalStorage.ts): `src/hooks/useLocalStorage.ts`

### Other components

- **Site visitor**

## Connections

- Site visitor → Route application: opens (evidence: `src/App.tsx`)
- Route application → Shared layout: wraps routes (evidence: `src/App.tsx`)
- Route application → Home page: routes to (evidence: `src/App.tsx`)
- Route application → Materials catalog: routes to (evidence: `src/App.tsx`)
- Route application → Material details: routes to (evidence: `src/App.tsx`)
- Route application → Product catalog: routes to (evidence: `src/App.tsx`)
- Route application → Process explorer: routes to (evidence: `src/App.tsx`)
- Route application → Impact education: routes to (evidence: `src/App.tsx`)
- Route application → Recycling quiz: routes to (evidence: `src/App.tsx`)
- Route application → Saved favorites: routes to (evidence: `src/App.tsx`)
- Shared layout → Global search dialog: renders (evidence: `src/layouts/AppLayout.tsx`)
- Process explorer → Journey explorer: renders (evidence: `src/pages/ProcessPage.tsx`)
- Process explorer → Process timeline: renders (evidence: `src/pages/ProcessPage.tsx`)
- Process explorer → Localized content access: loads localized data (evidence: `src/pages/ProcessPage.tsx`)
- Impact education → Localized content access: loads localized data (evidence: `src/pages/ImpactPage.tsx`)
- Recycling quiz → Localized content access: loads quiz content (evidence: `src/pages/QuizPage.tsx`)
- Localized content access → Material records: localizes (evidence: `src/hooks/useLocalizedData.ts`)
- Localized content access → Product records: localizes (evidence: `src/hooks/useLocalizedData.ts`)
- Localized content access → Process records: localizes (evidence: `src/hooks/useLocalizedData.ts`)
- Localized content access → Translation resources: uses translations (evidence: `src/hooks/useLocalizedData.ts`)
- Product records → Expanded products: assembles records (evidence: `src/data/products/index.ts`)
- Global search dialog → Cross-content search: queries (evidence: `src/components/layout/SearchDialog.tsx`)
- Global search dialog → Search state: uses search state (evidence: `src/components/layout/SearchDialog.tsx`)
- Cross-content search → Material records: searches (evidence: `src/utils/search.ts`)
- Cross-content search → Product records: searches (evidence: `src/utils/search.ts`)
- Cross-content search → Process records: searches (evidence: `src/utils/search.ts`)
- Favorites state → Browser storage hook: persists through (evidence: `src/context/FavoritesContext.tsx`)
- Route application → Language provider: provides language (evidence: `src/App.tsx`)
