# anubhabmondal496-coder/blindfold architecture

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

- Interactive diagram: https://gitdiagram.com/anubhabmondal496-coder/blindfold
- Repository: https://github.com/anubhabmondal496-coder/blindfold

## Overview

BlindFold is an audio-first vision assistant prototype for blind and low-vision users. In the implemented frontend, users start walking guidance or open the currency reader, then hear spoken prompts and receive vibration feedback; history and accessibility settings are additional screens. The repository also contains a separate INR-note CNN training workflow. Although the README describes YOLO, a backend, and mobile deployment, the provided tree shows no implementation for those systems, and the sampled reader screens use simulated detections rather than a demonstrated model connection.

Main entry points: [`frontend/src/App.jsx`](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/App.jsx) (App shell), [`train_CNN.py`](https://github.com/anubhabmondal496-coder/blindfold/blob/main/train_CNN.py) (CNN trainer), [`frontend/src/components/WalkingHome.jsx`](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/WalkingHome.jsx) (Walking home), [`frontend/src/components/LiveWalkingHUD.jsx`](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/LiveWalkingHUD.jsx) (Live walking HUD)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Accessible frontend"]
  node_app["App shell<br/>[App.jsx]"]
  node_walking["Walking home<br/>[WalkingHome.jsx]"]
  node_live["Live walking HUD<br/>[LiveWalkingHUD.jsx]"]
  node_currency["Currency reader<br/>[CurrencyReader.jsx]"]
  node_history["Detection history"]
  node_settings["Accessibility settings"]
  node_nav["Bottom navigation<br/>[BottomNav.jsx]"]
  node_header["Status header<br/>[Header.jsx]"]
end

subgraph group_model["Currency model"]
  node_trainer["CNN trainer<br/>[train_CNN.py]"]
  node_preprocess["Image preprocessing"]
  node_architecture["CNN architecture"]
  node_model_file["Trained currency model"]
end

node_user(("BlindFold user"))
node_browser["Browser speech and vibration"]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_walking
node_app -->|"renders"| node_live
node_app -->|"renders"| node_currency
node_app -->|"renders"| node_history
node_app -->|"renders"| node_settings
node_app -->|"renders"| node_nav
node_app -->|"renders"| node_header
node_walking -->|"requests mode changes"| node_app
node_app -->|"speaks and vibrates"| node_browser
node_live -->|"sends guidance"| node_app
node_currency -->|"sends announcements"| node_app
node_history -->|"sends replay"| node_app
node_settings -->|"updates preferences"| node_app
node_nav -->|"selects tab"| node_app
node_trainer -->|"loads datasets"| node_preprocess
node_trainer -->|"creates model"| node_architecture
node_trainer -->|"saves weights"| node_model_file

click node_app "https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/App.jsx"
click node_walking "https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/WalkingHome.jsx"
click node_live "https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/LiveWalkingHUD.jsx"
click node_currency "https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/CurrencyReader.jsx"
click node_history "https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/DetectionHistory.jsx"
click node_settings "https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/AccessibilitySettings.jsx"
click node_nav "https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/BottomNav.jsx"
click node_header "https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/Header.jsx"
click node_trainer "https://github.com/anubhabmondal496-coder/blindfold/blob/main/train_CNN.py"
click node_preprocess "https://github.com/anubhabmondal496-coder/blindfold/blob/main/image_normalization.py"
click node_architecture "https://github.com/anubhabmondal496-coder/blindfold/blob/main/CNN_Architecture.py"
click node_model_file "https://github.com/anubhabmondal496-coder/blindfold/blob/main/Currency_checking_model.h5"

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_walking,node_live,node_currency,node_history,node_settings,node_nav,node_header,node_user,node_browser toneBlue
class node_trainer,node_preprocess,node_architecture,node_model_file toneAmber
```

## Components

### Accessible frontend

- [App shell](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Walking home](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/WalkingHome.jsx): `frontend/src/components/WalkingHome.jsx`
- [Live walking HUD](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/LiveWalkingHUD.jsx): `frontend/src/components/LiveWalkingHUD.jsx`
- [Currency reader](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/CurrencyReader.jsx): `frontend/src/components/CurrencyReader.jsx`
- [Detection history](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/DetectionHistory.jsx): `frontend/src/components/DetectionHistory.jsx`
- [Accessibility settings](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/AccessibilitySettings.jsx): `frontend/src/components/AccessibilitySettings.jsx`
- [Bottom navigation](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/BottomNav.jsx): `frontend/src/components/BottomNav.jsx`
- [Status header](https://github.com/anubhabmondal496-coder/blindfold/blob/main/frontend/src/components/Header.jsx): `frontend/src/components/Header.jsx`

### Currency model

- [CNN trainer](https://github.com/anubhabmondal496-coder/blindfold/blob/main/train_CNN.py): `train_CNN.py`
- [Image preprocessing](https://github.com/anubhabmondal496-coder/blindfold/blob/main/image_normalization.py): `image_normalization.py`
- [CNN architecture](https://github.com/anubhabmondal496-coder/blindfold/blob/main/CNN_Architecture.py): `CNN_Architecture.py`
- [Trained currency model](https://github.com/anubhabmondal496-coder/blindfold/blob/main/Currency_checking_model.h5): `Currency_checking_model.h5`

### Other components

- **BlindFold user**
- **Browser speech and vibration**

## Connections

- BlindFold user → App shell: uses (evidence: `README.md`)
- App shell → Walking home: renders (evidence: `frontend/src/App.jsx`)
- App shell → Live walking HUD: renders (evidence: `frontend/src/App.jsx`)
- App shell → Currency reader: renders (evidence: `frontend/src/App.jsx`)
- App shell → Detection history: renders (evidence: `frontend/src/App.jsx`)
- App shell → Accessibility settings: renders (evidence: `frontend/src/App.jsx`)
- App shell → Bottom navigation: renders (evidence: `frontend/src/App.jsx`)
- App shell → Status header: renders (evidence: `frontend/src/App.jsx`)
- Walking home → App shell: requests mode changes (evidence: `frontend/src/App.jsx`)
- App shell → Browser speech and vibration: speaks and vibrates (evidence: `frontend/src/App.jsx`)
- Live walking HUD → App shell: sends guidance (evidence: `frontend/src/App.jsx`)
- Currency reader → App shell: sends announcements (evidence: `frontend/src/App.jsx`)
- Detection history → App shell: sends replay (evidence: `frontend/src/App.jsx`)
- Accessibility settings → App shell: updates preferences (evidence: `frontend/src/App.jsx`)
- Bottom navigation → App shell: selects tab (evidence: `frontend/src/App.jsx`)
- CNN trainer → Image preprocessing: loads datasets (evidence: `train_CNN.py`)
- CNN trainer → CNN architecture: creates model (evidence: `train_CNN.py`)
- CNN trainer → Trained currency model: saves weights (evidence: `train_CNN.py`)
