# aficat/flip-lms architecture

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

- Interactive diagram: https://gitdiagram.com/aficat/flip-lms
- Repository: https://github.com/aficat/flip-lms

## Overview

FLIP is a demo-mode learning management frontend for administrators, teachers, and students. The principal workflow begins at the demo landing or login page, enters role-specific routes, and presents course, assessment, engagement, and reporting tools in role-specific layouts. Authentication state is managed through a context backed by a mock-data store. The README documents broad capabilities, but the excerpts show no persistent backend or production integrations; unsampled feature relationships are represented at subsystem level rather than as detailed call flows.

Main entry points: [`src/contexts/AuthContext.tsx`](https://github.com/aficat/flip-lms/blob/main/src/contexts/AuthContext.tsx) (Auth context), [`src/App.tsx`](https://github.com/aficat/flip-lms/blob/main/src/App.tsx) (Routes and provider), [`src/pages/student`](https://github.com/aficat/flip-lms/tree/main/src/pages/student) (Student learning), [`src/pages/admin`](https://github.com/aficat/flip-lms/tree/main/src/pages/admin) (Admin tools)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["App entry"]
  node_app["Routes and provider<br/>[App.tsx]"]
  node_demo["Demo landing<br/>[DemoLanding.tsx]"]
  node_login["Public login"]
end

subgraph group_identity["Identity and state"]
  node_auth["Auth context<br/>[AuthContext.tsx]"]
  node_store["Mock data store<br/>[DataStore.ts]"]
  node_mockdata["Feature mock data<br/>[mockData.ts]"]
end

subgraph group_admin["Administration"]
  node_adminpages["Admin tools"]
  node_adminlayout["Admin layout<br/>[AdminLayout.tsx]"]
end

subgraph group_teaching["Teaching"]
  node_teacherpages["Teacher tools"]
  node_teacherlayout["Teacher layout<br/>[TeacherLayout.tsx]"]
end

subgraph group_learning["Learning experience"]
  node_studentpages["Student learning"]
  node_studentlayout["Student layout<br/>[StudentLayout.tsx]"]
  node_gamification["Learning gamification"]
end

subgraph group_shared["Shared interface"]
  node_ui["Reusable UI"]
  node_validation["Form validation<br/>[validation.ts]"]
  node_types["Domain types<br/>[course.ts]"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens demo"| node_demo
node_visitor -->|"opens login"| node_login
node_app -->|"routes to"| node_demo
node_app -->|"routes to"| node_login
node_app -->|"routes admin"| node_adminpages
node_app -->|"routes teacher"| node_teacherpages
node_app -->|"routes student"| node_studentpages
node_app -->|"provides context"| node_auth
node_login -->|"uses auth"| node_auth
node_login -->|"validates input"| node_validation
node_auth -->|"delegates login"| node_store
node_adminpages -->|"uses layout"| node_adminlayout
node_teacherpages -->|"uses layout"| node_teacherlayout
node_studentpages -->|"uses layout"| node_studentlayout
node_adminlayout -->|"reads identity"| node_auth
node_teacherlayout -->|"reads identity"| node_auth
node_studentlayout -->|"reads identity"| node_auth
node_studentpages -.->|"includes progress"| node_gamification
node_adminpages -->|"uses sample data"| node_mockdata
node_teacherpages -->|"uses sample data"| node_mockdata
node_studentpages -->|"uses sample data"| node_mockdata
node_adminpages -->|"renders controls"| node_ui
node_teacherpages -->|"renders controls"| node_ui
node_studentpages -->|"renders controls"| node_ui
node_auth -->|"uses course types"| node_types

click node_app "https://github.com/aficat/flip-lms/blob/main/src/App.tsx"
click node_demo "https://github.com/aficat/flip-lms/blob/main/src/pages/DemoLanding.tsx"
click node_login "https://github.com/aficat/flip-lms/blob/main/src/pages/auth/PublicLoginPage.tsx"
click node_auth "https://github.com/aficat/flip-lms/blob/main/src/contexts/AuthContext.tsx"
click node_store "https://github.com/aficat/flip-lms/blob/main/src/stores/DataStore.ts"
click node_mockdata "https://github.com/aficat/flip-lms/blob/main/src/data/mockData.ts"
click node_adminpages "https://github.com/aficat/flip-lms/tree/main/src/pages/admin"
click node_adminlayout "https://github.com/aficat/flip-lms/blob/main/src/components/layouts/AdminLayout.tsx"
click node_teacherpages "https://github.com/aficat/flip-lms/tree/main/src/pages/teacher"
click node_teacherlayout "https://github.com/aficat/flip-lms/blob/main/src/components/layouts/TeacherLayout.tsx"
click node_studentpages "https://github.com/aficat/flip-lms/tree/main/src/pages/student"
click node_studentlayout "https://github.com/aficat/flip-lms/blob/main/src/components/layouts/StudentLayout.tsx"
click node_gamification "https://github.com/aficat/flip-lms/tree/main/src/components/gamification"
click node_ui "https://github.com/aficat/flip-lms/tree/main/src/components/ui"
click node_validation "https://github.com/aficat/flip-lms/blob/main/src/utils/validation.ts"
click node_types "https://github.com/aficat/flip-lms/blob/main/src/types/course.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_demo,node_login toneBlue
class node_auth,node_store,node_mockdata toneAmber
class node_adminpages,node_adminlayout toneMint
class node_teacherpages,node_teacherlayout toneRose
class node_studentpages,node_studentlayout,node_gamification,node_visitor toneIndigo
class node_ui,node_validation,node_types toneTeal
```

## Components

### App entry

- [Routes and provider](https://github.com/aficat/flip-lms/blob/main/src/App.tsx): `src/App.tsx`
- [Demo landing](https://github.com/aficat/flip-lms/blob/main/src/pages/DemoLanding.tsx): `src/pages/DemoLanding.tsx`
- [Public login](https://github.com/aficat/flip-lms/blob/main/src/pages/auth/PublicLoginPage.tsx): `src/pages/auth/PublicLoginPage.tsx`

### Identity and state

- [Auth context](https://github.com/aficat/flip-lms/blob/main/src/contexts/AuthContext.tsx): `src/contexts/AuthContext.tsx`
- [Mock data store](https://github.com/aficat/flip-lms/blob/main/src/stores/DataStore.ts): `src/stores/DataStore.ts`
- [Feature mock data](https://github.com/aficat/flip-lms/blob/main/src/data/mockData.ts): `src/data/mockData.ts`

### Administration

- [Admin tools](https://github.com/aficat/flip-lms/tree/main/src/pages/admin): `src/pages/admin`
- [Admin layout](https://github.com/aficat/flip-lms/blob/main/src/components/layouts/AdminLayout.tsx): `src/components/layouts/AdminLayout.tsx`

### Teaching

- [Teacher tools](https://github.com/aficat/flip-lms/tree/main/src/pages/teacher): `src/pages/teacher`
- [Teacher layout](https://github.com/aficat/flip-lms/blob/main/src/components/layouts/TeacherLayout.tsx): `src/components/layouts/TeacherLayout.tsx`

### Learning experience

- [Student learning](https://github.com/aficat/flip-lms/tree/main/src/pages/student): `src/pages/student`
- [Student layout](https://github.com/aficat/flip-lms/blob/main/src/components/layouts/StudentLayout.tsx): `src/components/layouts/StudentLayout.tsx`
- [Learning gamification](https://github.com/aficat/flip-lms/tree/main/src/components/gamification): `src/components/gamification`

### Shared interface

- [Reusable UI](https://github.com/aficat/flip-lms/tree/main/src/components/ui): `src/components/ui`
- [Form validation](https://github.com/aficat/flip-lms/blob/main/src/utils/validation.ts): `src/utils/validation.ts`
- [Domain types](https://github.com/aficat/flip-lms/blob/main/src/types/course.ts): `src/types/course.ts`

### Other components

- **Visitor**

## Connections

- Visitor → Demo landing: opens demo
- Visitor → Public login: opens login
- Routes and provider → Demo landing: routes to (evidence: `src/App.tsx`)
- Routes and provider → Public login: routes to (evidence: `src/App.tsx`)
- Routes and provider → Admin tools: routes admin (evidence: `src/App.tsx`)
- Routes and provider → Teacher tools: routes teacher (evidence: `src/App.tsx`)
- Routes and provider → Student learning: routes student (evidence: `src/App.tsx`)
- Routes and provider → Auth context: provides context (evidence: `src/App.tsx`)
- Public login → Auth context: uses auth (evidence: `src/pages/auth/PublicLoginPage.tsx`)
- Public login → Form validation: validates input (evidence: `src/pages/auth/PublicLoginPage.tsx`)
- Auth context → Mock data store: delegates login (evidence: `src/contexts/AuthContext.tsx`)
- Admin tools → Admin layout: uses layout (evidence: `src/pages/admin/AdminUsers.tsx`)
- Teacher tools → Teacher layout: uses layout (evidence: `src/pages/teacher/TeacherForum.tsx`)
- Student learning → Student layout: uses layout (evidence: `src/pages/student/StudentForum.tsx`)
- Admin layout → Auth context: reads identity (evidence: `src/components/layouts/AdminLayout.tsx`)
- Teacher layout → Auth context: reads identity (evidence: `src/components/layouts/TeacherLayout.tsx`)
- Student layout → Auth context: reads identity (evidence: `src/components/layouts/StudentLayout.tsx`)
- Student learning → Learning gamification: includes progress
- Admin tools → Feature mock data: uses sample data (evidence: `src/pages/admin/AdminAnalytics.tsx`)
- Teacher tools → Feature mock data: uses sample data (evidence: `src/pages/teacher/TeacherAssignments.tsx`)
- Student learning → Feature mock data: uses sample data (evidence: `src/pages/student/StudentForum.tsx`)
- Admin tools → Reusable UI: renders controls (evidence: `src/pages/admin/AdminUsers.tsx`)
- Teacher tools → Reusable UI: renders controls (evidence: `src/pages/teacher/TeacherForum.tsx`)
- Student learning → Reusable UI: renders controls (evidence: `src/pages/student/StudentForum.tsx`)
- Auth context → Domain types: uses course types (evidence: `src/stores/DataStore.ts`)
