# mazennaji/mindmap-ai architecture

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

- Interactive diagram: https://gitdiagram.com/mazennaji/mindmap-ai
- Repository: https://github.com/mazennaji/mindmap-ai

## Overview

MindMap AI is a web and mobile learning platform that turns PDFs, DOCX files, YouTube transcripts, or notes into interactive knowledge maps, then supports tutoring, quizzes, collaboration, and progress tracking. The main flow is content intake, AI map generation, map exploration, and study feedback. The graph preserves documented product branches, including public discovery and real-time collaboration. Some subsystem paths are directories because their routes or screens were not sampled; edges for those capabilities are based on README statements, not inspected call sites.

Main entry points: [`mindmap-web/src/app`](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/app) (Web app), [`mindmap-web/src/lib/prisma/client.ts`](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/lib/prisma/client.ts) (Relational data), [`mindmap-web/src/app/api/maps`](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/app/api/maps) (Map API), [`mindmap-web/src/app/api/upload/route.ts`](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/upload/route.ts) (Document intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client apps"]
  node_web["Web app"]
  node_mobile["Mobile app"]
end

subgraph group_content["Content and maps"]
  node_intake["Document intake<br/>[route.ts]"]
  node_youtube["YouTube intake<br/>[route.ts]"]
  node_generation["Map generation<br/>[route.ts]"]
  node_mapapi["Map API"]
  node_mapview["Map experience"]
  node_mobilemap["Mobile map"]
end

subgraph group_learning["AI study"]
  node_tutor["AI tutor<br/>[route.ts]"]
  node_quiz["Quiz and grading<br/>[route.ts]"]
  node_flashcards["Flashcards<br/>[route.ts]"]
  node_analytics["Learning analytics<br/>[route.ts]"]
  node_mobiletutor["Mobile tutor<br/>[tutor.tsx]"]
end

subgraph group_community["Community and collaboration"]
  node_explore["Public discovery<br/>[route.ts]"]
  node_collaboration["Map collaboration<br/>[route.ts]"]
  node_comments["Comments and threads"]
end

subgraph group_platform["Platform services"]
  node_auth["Authentication"]
  node_database[("Relational data<br/>[client.ts]")]
  node_storage[("File storage<br/>[server.ts]")]
  node_realtime["Realtime services"]
end

node_learner(("Learner"))
node_gemini{{"Gemini AI"}}

node_learner -->|"uses"| node_web
node_learner -->|"uses"| node_mobile
node_web -.->|"submits files"| node_intake
node_web -.->|"submits link"| node_youtube
node_intake -->|"stores upload"| node_storage
node_intake -->|"records document"| node_database
node_youtube -->|"records transcript"| node_database
node_intake -.->|"provides text"| node_generation
node_youtube -.->|"provides transcript"| node_generation
node_generation -->|"generates graph"| node_gemini
node_generation -.->|"persists map"| node_database
node_web -.->|"manages maps"| node_mapapi
node_mapview -.->|"loads map"| node_mapapi
node_mobilemap -.->|"browses maps"| node_mapapi
node_mapapi -.->|"reads and writes"| node_database
node_web -.->|"requests tutoring"| node_tutor
node_mobiletutor -.->|"chats"| node_tutor
node_tutor -->|"answers with AI"| node_gemini
node_web -.->|"starts quizzes"| node_quiz
node_quiz -->|"generates and grades"| node_gemini
node_web -.->|"reviews cards"| node_flashcards
node_web -.->|"views progress"| node_analytics
node_analytics -->|"queries sessions"| node_database
node_web -.->|"discovers maps"| node_explore
node_explore -.->|"forks maps"| node_mapapi
node_web -.->|"invites people"| node_collaboration
node_collaboration -->|"saves roles"| node_database
node_mapview -.->|"syncs presence"| node_realtime
node_mapview -.->|"opens discussions"| node_comments
node_web -->|"authenticates"| node_auth
node_mobile -->|"authenticates"| node_auth

click node_web "https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/app"
click node_mobile "https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-mobile/app"
click node_intake "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/upload/route.ts"
click node_youtube "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/youtube/route.ts"
click node_generation "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/ai/generate-map/route.ts"
click node_mapapi "https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/app/api/maps"
click node_mapview "https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/components/map"
click node_mobilemap "https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-mobile/app/map"
click node_tutor "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/ai/chat/route.ts"
click node_quiz "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/ai/quiz/route.ts"
click node_flashcards "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/flashcards/route.ts"
click node_analytics "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/analytics/route.ts"
click node_mobiletutor "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-mobile/app/map/%5Bid%5D/tutor.tsx"
click node_explore "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/explore/route.ts"
click node_collaboration "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/collaborators/route.ts"
click node_comments "https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/app/api/comments"
click node_auth "https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/lib/supabase"
click node_database "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/lib/prisma/client.ts"
click node_storage "https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/lib/supabase/server.ts"
click node_realtime "https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/lib/firebase"

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_web,node_mobile toneBlue
class node_intake,node_youtube,node_generation,node_mapapi,node_mapview,node_mobilemap toneAmber
class node_tutor,node_quiz,node_flashcards,node_analytics,node_mobiletutor toneMint
class node_explore,node_collaboration,node_comments toneRose
class node_auth,node_database,node_storage,node_realtime,node_learner,node_gemini toneIndigo
```

## Components

### Client apps

- [Web app](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/app): `mindmap-web/src/app`
- [Mobile app](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-mobile/app): `mindmap-mobile/app`

### Content and maps

- [Document intake](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/upload/route.ts): `mindmap-web/src/app/api/upload/route.ts`
- [YouTube intake](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/youtube/route.ts): `mindmap-web/src/app/api/youtube/route.ts`
- [Map generation](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/ai/generate-map/route.ts): `mindmap-web/src/app/api/ai/generate-map/route.ts`
- [Map API](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/app/api/maps): `mindmap-web/src/app/api/maps`
- [Map experience](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/components/map): `mindmap-web/src/components/map`
- [Mobile map](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-mobile/app/map): `mindmap-mobile/app/map`

### AI study

- [AI tutor](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/ai/chat/route.ts): `mindmap-web/src/app/api/ai/chat/route.ts`
- [Quiz and grading](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/ai/quiz/route.ts): `mindmap-web/src/app/api/ai/quiz/route.ts`
- [Flashcards](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/flashcards/route.ts): `mindmap-web/src/app/api/flashcards/route.ts`
- [Learning analytics](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/analytics/route.ts): `mindmap-web/src/app/api/analytics/route.ts`
- [Mobile tutor](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-mobile/app/map/%5Bid%5D/tutor.tsx): `mindmap-mobile/app/map/[id]/tutor.tsx`

### Community and collaboration

- [Public discovery](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/explore/route.ts): `mindmap-web/src/app/api/explore/route.ts`
- [Map collaboration](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/app/api/collaborators/route.ts): `mindmap-web/src/app/api/collaborators/route.ts`
- [Comments and threads](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/app/api/comments): `mindmap-web/src/app/api/comments`

### Platform services

- [Authentication](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/lib/supabase): `mindmap-web/src/lib/supabase`
- [Relational data](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/lib/prisma/client.ts): `mindmap-web/src/lib/prisma/client.ts`
- [File storage](https://github.com/mazennaji/mindmap-ai/blob/main/mindmap-web/src/lib/supabase/server.ts): `mindmap-web/src/lib/supabase/server.ts`
- [Realtime services](https://github.com/mazennaji/mindmap-ai/tree/main/mindmap-web/src/lib/firebase): `mindmap-web/src/lib/firebase`

### Other components

- **Learner**
- **Gemini AI**

## Connections

- Learner → Web app: uses (evidence: `README.md`)
- Learner → Mobile app: uses (evidence: `README.md`)
- Web app → Document intake: submits files
- Web app → YouTube intake: submits link
- Document intake → File storage: stores upload (evidence: `mindmap-web/src/app/api/upload/route.ts`)
- Document intake → Relational data: records document (evidence: `mindmap-web/src/app/api/upload/route.ts`)
- YouTube intake → Relational data: records transcript (evidence: `mindmap-web/src/app/api/youtube/route.ts`)
- Document intake → Map generation: provides text
- YouTube intake → Map generation: provides transcript
- Map generation → Gemini AI: generates graph (evidence: `README.md`)
- Map generation → Relational data: persists map
- Web app → Map API: manages maps
- Map experience → Map API: loads map
- Mobile map → Map API: browses maps
- Map API → Relational data: reads and writes
- Web app → AI tutor: requests tutoring
- Mobile tutor → AI tutor: chats
- AI tutor → Gemini AI: answers with AI (evidence: `README.md`)
- Web app → Quiz and grading: starts quizzes
- Quiz and grading → Gemini AI: generates and grades (evidence: `README.md`)
- Web app → Flashcards: reviews cards
- Web app → Learning analytics: views progress
- Learning analytics → Relational data: queries sessions (evidence: `mindmap-web/src/app/api/analytics/route.ts`)
- Web app → Public discovery: discovers maps
- Public discovery → Map API: forks maps
- Web app → Map collaboration: invites people
- Map collaboration → Relational data: saves roles (evidence: `mindmap-web/src/app/api/collaborators/route.ts`)
- Map experience → Realtime services: syncs presence (evidence: `README.md`)
- Map experience → Comments and threads: opens discussions (evidence: `README.md`)
- Web app → Authentication: authenticates
- Mobile app → Authentication: authenticates (evidence: `README.md`)
