# thakurnarsing999/sign-bridge architecture

> Architecture diagram of the GitHub repository thakurnarsing999/sign-bridge, 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/thakurnarsing999/sign-bridge
- Repository: https://github.com/thakurnarsing999/sign-bridge

## Overview

SignBridge is a browser-based ISL assistive app. Its primary workflow is camera capture, dual-hand landmark tracking, gesture classification, transcript assembly, and optional speech synthesis. The UI also supports sign-reference browsing and a speech-to-sign mode. The tree and README establish these capabilities, but App.jsx and several feature components were not sampled, so their internal wiring is shown only as unverified where needed.

Main entry points: [`src/App.jsx`](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/App.jsx) (App Orchestrator), [`src/components/ReferenceGuideDrawer.jsx`](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/ReferenceGuideDrawer.jsx) (Reference Guide), [`src/components/CameraPanel.jsx`](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/CameraPanel.jsx) (Camera Panel), [`src/components/TranscriptPanel.jsx`](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/TranscriptPanel.jsx) (Transcript Builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Application UI"]
  node_app_entry["React Entry<br/>[main.jsx]"]
  node_app["App Orchestrator<br/>[App.jsx]"]
  node_landing["Landing Navigation<br/>[LandingPage.jsx]"]
  node_header["App Navigation<br/>[Header.jsx]"]
  node_settings["Settings<br/>[SettingsModal.jsx]"]
  node_onboarding["Onboarding"]
  node_actions["Floating Actions"]
end

subgraph group_recognition["Gesture Recognition"]
  node_camera["Camera Panel<br/>[CameraPanel.jsx]"]
  node_models["Browser Models"]
end

subgraph group_communication["Text And Speech"]
  node_transcript["Transcript Builder"]
  node_speech_sign["Speech To Sign"]
end

subgraph group_reference["Sign Reference"]
  node_glyph["Sign Glyphs<br/>[SignGlyph.jsx]"]
  node_reference_drawer["Reference Guide"]
  node_isl_data["ISL Sign Data<br/>[islData.js]"]
  node_metadata["ISL Metadata<br/>[isl_metadata.json]"]
end

node_user(("User"))
node_browser{{"Browser APIs"}}
node_mediapipe{{"MediaPipe Vision"}}

node_app_entry -->|"renders"| node_app
node_user -.->|"enables capture"| node_camera
node_camera -.->|"tracks landmarks"| node_mediapipe
node_mediapipe -.->|"provides landmarks"| node_app
node_app -.->|"classifies gestures"| node_models
node_app -.->|"assembles signs"| node_transcript
node_transcript -.->|"speaks text"| node_browser
node_user -->|"chooses mode"| node_landing
node_reference_drawer -->|"reads sign entries"| node_isl_data
node_reference_drawer -->|"renders glyphs"| node_glyph
node_app -.->|"offers mode"| node_speech_sign

click node_app_entry "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/main.jsx"
click node_app "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/App.jsx"
click node_landing "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/LandingPage.jsx"
click node_header "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/Header.jsx"
click node_settings "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/SettingsModal.jsx"
click node_onboarding "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/OnboardingModal.jsx"
click node_actions "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/FloatingActions.jsx"
click node_camera "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/CameraPanel.jsx"
click node_models "https://github.com/thakurnarsing999/sign-bridge/tree/main/public/model"
click node_transcript "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/TranscriptPanel.jsx"
click node_speech_sign "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/SpeechToSignPanel.jsx"
click node_glyph "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/SignGlyph.jsx"
click node_reference_drawer "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/ReferenceGuideDrawer.jsx"
click node_isl_data "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/data/islData.js"
click node_metadata "https://github.com/thakurnarsing999/sign-bridge/blob/main/src/data/isl_metadata.json"

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_entry,node_app,node_landing,node_header,node_settings,node_onboarding,node_actions,node_user,node_browser toneBlue
class node_camera,node_models toneAmber
class node_transcript,node_speech_sign,node_mediapipe toneMint
class node_glyph,node_reference_drawer,node_isl_data,node_metadata toneRose
```

## Components

### Application UI

- [React Entry](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/main.jsx): `src/main.jsx`
- [App Orchestrator](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/App.jsx): `src/App.jsx`
- [Landing Navigation](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/LandingPage.jsx): `src/components/LandingPage.jsx`
- [App Navigation](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/Header.jsx): `src/components/Header.jsx`
- [Settings](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/SettingsModal.jsx): `src/components/SettingsModal.jsx`
- [Onboarding](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/OnboardingModal.jsx): `src/components/OnboardingModal.jsx`
- [Floating Actions](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/FloatingActions.jsx): `src/components/FloatingActions.jsx`

### Gesture Recognition

- [Camera Panel](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/CameraPanel.jsx): `src/components/CameraPanel.jsx`
- [Browser Models](https://github.com/thakurnarsing999/sign-bridge/tree/main/public/model): `public/model`

### Text And Speech

- [Transcript Builder](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/TranscriptPanel.jsx): `src/components/TranscriptPanel.jsx`
- [Speech To Sign](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/SpeechToSignPanel.jsx): `src/components/SpeechToSignPanel.jsx`

### Sign Reference

- [Sign Glyphs](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/SignGlyph.jsx): `src/components/SignGlyph.jsx`
- [Reference Guide](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/components/ReferenceGuideDrawer.jsx): `src/components/ReferenceGuideDrawer.jsx`
- [ISL Sign Data](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/data/islData.js): `src/data/islData.js`
- [ISL Metadata](https://github.com/thakurnarsing999/sign-bridge/blob/main/src/data/isl_metadata.json): `src/data/isl_metadata.json`

### Other components

- **User**
- **Browser APIs**
- **MediaPipe Vision**

## Connections

- React Entry → App Orchestrator: renders (evidence: `src/main.jsx`)
- User → Camera Panel: enables capture
- Camera Panel → MediaPipe Vision: tracks landmarks
- MediaPipe Vision → App Orchestrator: provides landmarks
- App Orchestrator → Browser Models: classifies gestures
- App Orchestrator → Transcript Builder: assembles signs
- Transcript Builder → Browser APIs: speaks text
- User → Landing Navigation: chooses mode (evidence: `src/components/LandingPage.jsx`)
- Reference Guide → ISL Sign Data: reads sign entries (evidence: `src/components/ReferenceGuideDrawer.jsx`)
- Reference Guide → Sign Glyphs: renders glyphs (evidence: `src/components/ReferenceGuideDrawer.jsx`)
- App Orchestrator → Speech To Sign: offers mode
