How mazennaji/mindmap-ai works
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: app Web app · client.ts Relational data · maps Map API · route.ts Document intake
Components 22
Client apps
- Web app
mindmap-web/src/app - Mobile app
mindmap-mobile/app
Content and maps
- Document intake
mindmap-web/src/app/api/upload/route.ts - YouTube intake
mindmap-web/src/app/api/youtube/route.ts - Map generation
mindmap-web/src/app/api/ai/generate-map/route.ts - Map API
mindmap-web/src/app/api/maps - Map experience
mindmap-web/src/components/map - Mobile map
mindmap-mobile/app/map
AI study
- AI tutor
mindmap-web/src/app/api/ai/chat/route.ts - Quiz and grading
mindmap-web/src/app/api/ai/quiz/route.ts - Flashcards
mindmap-web/src/app/api/flashcards/route.ts - Learning analytics
mindmap-web/src/app/api/analytics/route.ts - Mobile tutor
mindmap-mobile/app/map/[id]/tutor.tsx
Community and collaboration
- Public discovery
mindmap-web/src/app/api/explore/route.ts - Map collaboration
mindmap-web/src/app/api/collaborators/route.ts - Comments and threads
mindmap-web/src/app/api/comments
Platform services
- Authentication
mindmap-web/src/lib/supabase - Relational data
mindmap-web/src/lib/prisma/client.ts - File storage
mindmap-web/src/lib/supabase/server.ts - Realtime services
mindmap-web/src/lib/firebase
Other components
- Learner
- Gemini AI
Connections 31
- Learner → Web app: uses
README.md - Learner → Mobile app: uses
README.md - Web app → Document intake: submits files
- Web app → YouTube intake: submits link
- Document intake → File storage: stores upload
mindmap-web/src/app/api/upload/route.ts - Document intake → Relational data: records document
mindmap-web/src/app/api/upload/route.ts - YouTube intake → Relational data: records transcript
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
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
README.md - Web app → Quiz and grading: starts quizzes
- Quiz and grading → Gemini AI: generates and grades
README.md - Web app → Flashcards: reviews cards
- Web app → Learning analytics: views progress
- Learning analytics → Relational data: queries sessions
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
mindmap-web/src/app/api/collaborators/route.ts - Map experience → Realtime services: syncs presence
README.md - Map experience → Comments and threads: opens discussions
README.md - Web app → Authentication: authenticates
- Mobile app → Authentication: authenticates
README.md