# akashkmr9225-de/educafe-hub architecture

> Architecture diagram of the GitHub repository akashkmr9225-de/educafe-hub, 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/akashkmr9225-de/educafe-hub
- Repository: https://github.com/akashkmr9225-de/educafe-hub

## Overview

EduCafe Hub is a browser-based toolkit for schools and cyber cafes. Users browse the home page’s tool catalogue, choose a task such as preparing photos or PDFs, and process files on their device; the README says files are not uploaded. The app also offers calculators, QR and receipt tools, bulk student-photo workflows, daily official links, English/Hindi, optional local profiles, and legal information. Page composition is visible in the sampled source; several tool implementations are identified by tree paths and README capabilities, but their internal dispatch wiring was not sampled.

Main entry points: [`next-app/src/components/sites/educafehub/ToolGrid.tsx`](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/ToolGrid.tsx) (Tool catalogue), [`next-app/src/app/page.tsx`](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/app/page.tsx) (Home page), [`next-app/src/components/sites/educafehub/runtime/auth-helpers.ts`](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/auth-helpers.ts) (Profile state), [`next-app/src/components/sites/educafehub/AuthModal.tsx`](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/AuthModal.tsx) (Profile modal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_home["Home page<br/>[page.tsx]"]
  node_catalogue["Tool catalogue<br/>[ToolGrid.tsx]"]
end

subgraph group_photo["Photo workflows"]
  node_photo_tools["Photo tools<br/>[tools-photo.ts]"]
  node_bulk_photos["Bulk student photos<br/>[tool-bulk.ts]"]
end

subgraph group_documents["Documents and utilities"]
  node_pdf_tools["PDF tools<br/>[tools-pdf.ts]"]
  node_calculators["Calculators<br/>[tools-calc.ts]"]
  node_qr_tool["QR maker<br/>[tool-qr.ts]"]
  node_receipt_tool["Receipt maker<br/>[tool-receipt.ts]"]
end

subgraph group_engagement["Audience and access"]
  node_links["Daily links<br/>[Links.tsx]"]
  node_audiences["Audience sections<br/>[Audience.tsx]"]
  node_language["Language selection<br/>[useLang.ts]"]
  node_auth_modal["Profile modal<br/>[AuthModal.tsx]"]
  node_legal["Legal information<br/>[Legal.tsx]"]
end

subgraph group_runtime["Runtime state"]
  node_auth_state["Profile state<br/>[auth-helpers.ts]"]
  node_tool_state["Tool state and text<br/>[state.ts]"]
  node_runtime_shell["Runtime shell<br/>[app-shell.ts]"]
  node_local_storage[("Browser local storage")]
end

node_visitor(("Visitor"))

node_visitor -->|"opens"| node_home
node_home -->|"renders"| node_catalogue
node_home -->|"mounts"| node_runtime_shell
node_catalogue -.->|"offers"| node_photo_tools
node_catalogue -.->|"offers"| node_bulk_photos
node_catalogue -.->|"offers"| node_pdf_tools
node_catalogue -.->|"offers"| node_calculators
node_catalogue -.->|"offers"| node_qr_tool
node_catalogue -.->|"offers"| node_receipt_tool
node_auth_modal -->|"reads and updates"| node_auth_state
node_auth_state -->|"persists profile"| node_local_storage

click node_home "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/app/page.tsx"
click node_catalogue "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/ToolGrid.tsx"
click node_photo_tools "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tools-photo.ts"
click node_bulk_photos "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tool-bulk.ts"
click node_pdf_tools "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tools-pdf.ts"
click node_calculators "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tools-calc.ts"
click node_qr_tool "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tool-qr.ts"
click node_receipt_tool "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tool-receipt.ts"
click node_links "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/Links.tsx"
click node_audiences "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/Audience.tsx"
click node_language "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/hooks/useLang.ts"
click node_auth_modal "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/AuthModal.tsx"
click node_auth_state "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/auth-helpers.ts"
click node_tool_state "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/state.ts"
click node_runtime_shell "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/app-shell.ts"
click node_legal "https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/Legal.tsx"

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_home,node_catalogue toneBlue
class node_photo_tools,node_bulk_photos toneAmber
class node_pdf_tools,node_calculators,node_qr_tool,node_receipt_tool toneMint
class node_links,node_audiences,node_language,node_auth_modal,node_legal toneRose
class node_auth_state,node_tool_state,node_runtime_shell,node_local_storage,node_visitor toneIndigo
```

## Components

### App entry

- [Home page](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/app/page.tsx): `next-app/src/app/page.tsx`
- [Tool catalogue](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/ToolGrid.tsx): `next-app/src/components/sites/educafehub/ToolGrid.tsx`

### Photo workflows

- [Photo tools](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tools-photo.ts): `next-app/src/components/sites/educafehub/runtime/tools-photo.ts`
- [Bulk student photos](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tool-bulk.ts): `next-app/src/components/sites/educafehub/runtime/tool-bulk.ts`

### Documents and utilities

- [PDF tools](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tools-pdf.ts): `next-app/src/components/sites/educafehub/runtime/tools-pdf.ts`
- [Calculators](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tools-calc.ts): `next-app/src/components/sites/educafehub/runtime/tools-calc.ts`
- [QR maker](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tool-qr.ts): `next-app/src/components/sites/educafehub/runtime/tool-qr.ts`
- [Receipt maker](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/tool-receipt.ts): `next-app/src/components/sites/educafehub/runtime/tool-receipt.ts`

### Audience and access

- [Daily links](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/Links.tsx): `next-app/src/components/sites/educafehub/Links.tsx`
- [Audience sections](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/Audience.tsx): `next-app/src/components/sites/educafehub/Audience.tsx`
- [Language selection](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/hooks/useLang.ts): `next-app/src/hooks/useLang.ts`
- [Profile modal](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/AuthModal.tsx): `next-app/src/components/sites/educafehub/AuthModal.tsx`
- [Legal information](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/Legal.tsx): `next-app/src/components/sites/educafehub/Legal.tsx`

### Runtime state

- [Profile state](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/auth-helpers.ts): `next-app/src/components/sites/educafehub/runtime/auth-helpers.ts`
- [Tool state and text](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/state.ts): `next-app/src/components/sites/educafehub/runtime/state.ts`
- [Runtime shell](https://github.com/akashkmr9225-de/educafe-hub/blob/main/next-app/src/components/sites/educafehub/runtime/app-shell.ts): `next-app/src/components/sites/educafehub/runtime/app-shell.ts`
- **Browser local storage**

### Other components

- **Visitor**

## Connections

- Visitor → Home page: opens (evidence: `next-app/src/app/page.tsx`)
- Home page → Tool catalogue: renders (evidence: `next-app/src/app/page.tsx`)
- Home page → Runtime shell: mounts (evidence: `next-app/src/app/page.tsx`)
- Tool catalogue → Photo tools: offers
- Tool catalogue → Bulk student photos: offers
- Tool catalogue → PDF tools: offers
- Tool catalogue → Calculators: offers
- Tool catalogue → QR maker: offers
- Tool catalogue → Receipt maker: offers
- Profile modal → Profile state: reads and updates (evidence: `next-app/src/components/sites/educafehub/AuthModal.tsx`)
- Profile state → Browser local storage: persists profile (evidence: `next-app/src/components/sites/educafehub/runtime/auth-helpers.ts`)
