# modulyai-mvjexpo/modulyai architecture

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

- Interactive diagram: https://gitdiagram.com/modulyai-mvjexpo/modulyai
- Repository: https://github.com/modulyai-mvjexpo/modulyai

## Overview

This is a student-facing AI study application with authentication, onboarding, document-backed chat, study sets, exam practice, document management, and administration. The user journey is landing page or sign-in, profile setup, then dashboard-driven learning modes; serverless endpoints provide AI and document operations. Source excerpts establish several frontend calls and AI endpoint dependencies, but not the complete browser-to-endpoint wiring or unsampled document-processing behavior, so those links are omitted rather than inferred.

Main entry points: [`src/App.tsx`](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/App.tsx) (App and routing), [`src/pages/Dashboard.tsx`](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Dashboard.tsx) (Dashboard), [`netlify/functions/chat.mts`](https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/chat.mts) (Chat endpoint), [`src/pages/Chat.tsx`](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Chat.tsx) (Chat)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Student application"]
  node_app["App and routing<br/>[App.tsx]"]
  node_authmodal["Sign-in and signup<br/>[AuthModal.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_onboarding["Onboarding<br/>[Onboarding.tsx]"]
  node_chat["Chat<br/>[Chat.tsx]"]
  node_study["Study mode<br/>[StudyMode.tsx]"]
  node_exam["Exam mode<br/>[ExamMode.tsx]"]
  node_library["Document library<br/>[Library.tsx]"]
  node_upload["Document upload<br/>[UploadDocs.tsx]"]
  node_adminui["Admin panel<br/>[AdminPanel.tsx]"]
  node_picker["Document picker"]
  node_markdown["Markdown rendering<br/>[renderMarkdown.ts]"]
end

subgraph group_identity["Identity and profiles"]
  node_auth["Authentication helpers<br/>[auth.ts]"]
  node_profile["Profile management<br/>[profile.ts]"]
end

subgraph group_ai["AI services"]
  node_aisupabase["Server Supabase access<br/>[supabase-server.ts]"]
  node_llm["LLM provider routing<br/>[llm.ts]"]
  node_embeddings["Embedding providers"]
  node_embedding["Embedding utilities<br/>[embedding.ts]"]
  node_reranker["Result reranking<br/>[reranker.ts]"]
  node_grounding["Document grounding<br/>[docGrounding.ts]"]
end

subgraph group_platform["Backend and documents"]
  node_supabase["Supabase client<br/>[supabase.ts]"]
  node_chatapi["Chat endpoint<br/>[chat.mts]"]
  node_examapi["Exam solve endpoint<br/>[exam-solve.mts]"]
  node_adminapi["Admin users endpoint<br/>[admin-users.mts]"]
  node_docprocess["Document processing"]
  node_docbackground["Background processing"]
  node_parsedoc["Parsed document access<br/>[get-parsed-doc.mts]"]
  node_pyq["Past-paper intelligence"]
  node_studysets["Study set storage<br/>[studySets.ts]"]
end

node_visitor(("Student"))

node_visitor -->|"opens"| node_app
node_app -->|"opens"| node_authmodal
node_app -->|"renders"| node_dashboard
node_app -->|"renders"| node_onboarding
node_app -->|"loads profile"| node_profile
node_authmodal -->|"calls"| node_auth
node_authmodal -->|"writes profile"| node_profile
node_auth -->|"looks up username"| node_profile
node_auth -->|"auth operations"| node_supabase
node_profile -->|"reads and writes"| node_supabase
node_dashboard -->|"selects"| node_chat
node_dashboard -->|"selects"| node_library
node_dashboard -->|"selects"| node_upload
node_dashboard -->|"selects"| node_adminui
node_chat -->|"renders"| node_exam
node_chat -->|"renders"| node_picker
node_chat -->|"renders with"| node_markdown
node_study -->|"renders"| node_picker
node_study -->|"renders with"| node_markdown
node_study -->|"manages sets"| node_studysets
node_adminui -->|"requests"| node_adminapi
node_chatapi -->|"uses"| node_aisupabase
node_chatapi -->|"calls"| node_llm
node_chatapi -->|"calls"| node_embeddings
node_chatapi -->|"calls"| node_reranker
node_examapi -->|"uses"| node_aisupabase
node_examapi -->|"calls"| node_llm
node_examapi -->|"calls"| node_embedding
node_adminapi -->|"uses"| node_aisupabase
node_grounding -.-> node_docprocess

click node_app "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/App.tsx"
click node_authmodal "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/components/AuthModal.tsx"
click node_dashboard "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Dashboard.tsx"
click node_onboarding "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Onboarding.tsx"
click node_chat "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Chat.tsx"
click node_study "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/StudyMode.tsx"
click node_exam "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/ExamMode.tsx"
click node_library "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Library.tsx"
click node_upload "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/UploadDocs.tsx"
click node_adminui "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/AdminPanel.tsx"
click node_picker "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/components/DocumentPickerModal.tsx"
click node_markdown "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/renderMarkdown.ts"
click node_auth "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/auth.ts"
click node_profile "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/profile.ts"
click node_supabase "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/supabase.ts"
click node_chatapi "https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/chat.mts"
click node_examapi "https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/exam-solve.mts"
click node_adminapi "https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/admin-users.mts"
click node_docprocess "https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/process-document.mts"
click node_docbackground "https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/process-document-background.mts"
click node_parsedoc "https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/get-parsed-doc.mts"
click node_pyq "https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/pyq-intelligence.mts"
click node_aisupabase "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/supabase-server.ts"
click node_llm "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/llm.ts"
click node_embeddings "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/langchain-embeddings.ts"
click node_embedding "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/embedding.ts"
click node_reranker "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/reranker.ts"
click node_grounding "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/docGrounding.ts"
click node_studysets "https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/studySets.ts"

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_authmodal,node_dashboard,node_onboarding,node_chat,node_study,node_exam,node_library,node_upload,node_adminui,node_picker,node_markdown toneBlue
class node_auth,node_profile toneAmber
class node_aisupabase,node_llm,node_embeddings,node_embedding,node_reranker,node_grounding toneMint
class node_supabase,node_chatapi,node_examapi,node_adminapi,node_docprocess,node_docbackground,node_parsedoc,node_pyq,node_studysets toneRose
class node_visitor toneIndigo
```

## Components

### Student application

- [App and routing](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/App.tsx): `src/App.tsx`
- [Sign-in and signup](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/components/AuthModal.tsx): `src/components/AuthModal.tsx`
- [Dashboard](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Onboarding](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Onboarding.tsx): `src/pages/Onboarding.tsx`
- [Chat](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Chat.tsx): `src/pages/Chat.tsx`
- [Study mode](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/StudyMode.tsx): `src/pages/StudyMode.tsx`
- [Exam mode](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/ExamMode.tsx): `src/pages/ExamMode.tsx`
- [Document library](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/Library.tsx): `src/pages/Library.tsx`
- [Document upload](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/UploadDocs.tsx): `src/pages/UploadDocs.tsx`
- [Admin panel](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/pages/AdminPanel.tsx): `src/pages/AdminPanel.tsx`
- [Document picker](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/components/DocumentPickerModal.tsx): `src/components/DocumentPickerModal.tsx`
- [Markdown rendering](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/renderMarkdown.ts): `src/lib/renderMarkdown.ts`

### Identity and profiles

- [Authentication helpers](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Profile management](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/profile.ts): `src/lib/profile.ts`

### AI services

- [Server Supabase access](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/supabase-server.ts): `src/lib/ai/supabase-server.ts`
- [LLM provider routing](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/llm.ts): `src/lib/ai/llm.ts`
- [Embedding providers](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/langchain-embeddings.ts): `src/lib/ai/langchain-embeddings.ts`
- [Embedding utilities](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/embedding.ts): `src/lib/ai/embedding.ts`
- [Result reranking](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/ai/reranker.ts): `src/lib/ai/reranker.ts`
- [Document grounding](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/docGrounding.ts): `src/lib/docGrounding.ts`

### Backend and documents

- [Supabase client](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`
- [Chat endpoint](https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/chat.mts): `netlify/functions/chat.mts`
- [Exam solve endpoint](https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/exam-solve.mts): `netlify/functions/exam-solve.mts`
- [Admin users endpoint](https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/admin-users.mts): `netlify/functions/admin-users.mts`
- [Document processing](https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/process-document.mts): `netlify/functions/process-document.mts`
- [Background processing](https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/process-document-background.mts): `netlify/functions/process-document-background.mts`
- [Parsed document access](https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/get-parsed-doc.mts): `netlify/functions/get-parsed-doc.mts`
- [Past-paper intelligence](https://github.com/modulyai-mvjexpo/modulyai/blob/main/netlify/functions/pyq-intelligence.mts): `netlify/functions/pyq-intelligence.mts`
- [Study set storage](https://github.com/modulyai-mvjexpo/modulyai/blob/main/src/lib/studySets.ts): `src/lib/studySets.ts`

### Other components

- **Student**

## Connections

- Student → App and routing: opens (evidence: `src/App.tsx`)
- App and routing → Sign-in and signup: opens (evidence: `src/App.tsx`)
- App and routing → Dashboard: renders (evidence: `src/App.tsx`)
- App and routing → Onboarding: renders (evidence: `src/App.tsx`)
- App and routing → Profile management: loads profile (evidence: `src/App.tsx`)
- Sign-in and signup → Authentication helpers: calls (evidence: `src/components/AuthModal.tsx`)
- Sign-in and signup → Profile management: writes profile (evidence: `src/components/AuthModal.tsx`)
- Authentication helpers → Profile management: looks up username (evidence: `src/lib/auth.ts`)
- Authentication helpers → Supabase client: auth operations (evidence: `src/lib/auth.ts`)
- Profile management → Supabase client: reads and writes (evidence: `src/lib/profile.ts`)
- Dashboard → Chat: selects (evidence: `src/pages/Dashboard.tsx`)
- Dashboard → Document library: selects (evidence: `src/pages/Dashboard.tsx`)
- Dashboard → Document upload: selects (evidence: `src/pages/Dashboard.tsx`)
- Dashboard → Admin panel: selects (evidence: `src/pages/Dashboard.tsx`)
- Chat → Exam mode: renders (evidence: `src/pages/Chat.tsx`)
- Chat → Document picker: renders (evidence: `src/pages/Chat.tsx`)
- Chat → Markdown rendering: renders with (evidence: `src/pages/Chat.tsx`)
- Study mode → Document picker: renders (evidence: `src/pages/StudyMode.tsx`)
- Study mode → Markdown rendering: renders with (evidence: `src/pages/StudyMode.tsx`)
- Study mode → Study set storage: manages sets (evidence: `src/pages/StudyMode.tsx`)
- Admin panel → Admin users endpoint: requests (evidence: `src/pages/AdminPanel.tsx`)
- Chat endpoint → Server Supabase access: uses (evidence: `netlify/functions/chat.mts`)
- Chat endpoint → LLM provider routing: calls (evidence: `netlify/functions/chat.mts`)
- Chat endpoint → Embedding providers: calls (evidence: `netlify/functions/chat.mts`)
- Chat endpoint → Result reranking: calls (evidence: `netlify/functions/chat.mts`)
- Exam solve endpoint → Server Supabase access: uses (evidence: `netlify/functions/exam-solve.mts`)
- Exam solve endpoint → LLM provider routing: calls (evidence: `netlify/functions/exam-solve.mts`)
- Exam solve endpoint → Embedding utilities: calls (evidence: `netlify/functions/exam-solve.mts`)
- Admin users endpoint → Server Supabase access: uses (evidence: `netlify/functions/admin-users.mts`)
- Document grounding → Document processing
