# burrarohith66/neuronxai architecture

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

- Interactive diagram: https://gitdiagram.com/burrarohith66/neuronxai
- Repository: https://github.com/burrarohith66/neuronxai

## Overview

NeuronX AI is a student learning and progression dashboard. A student enters through the landing or account flow, then uses the app shell to reach academic subjects and chapter study, AI tutoring, skill development, planning, and revision; dashboard, analytics, achievements, and leaderboard present progress and motivation. The sampled store implements demo login/registration and persisted user state, while mockData supplies learning and leaderboard content. Connections follow explicit imports or visible navigation; the AI tutor UI/API relationship is shown as unverified because the excerpts do not establish how they connect.

Main entry points: [`src/lib/store.ts`](https://github.com/burrarohith66/neuronxai/blob/main/src/lib/store.ts) (Auth state), [`src/lib/mockData.ts`](https://github.com/burrarohith66/neuronxai/blob/main/src/lib/mockData.ts) (Learning demo data), [`src/app/(app)/dashboard/page.tsx`](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/dashboard/page.tsx) (Dashboard), [`src/app/(app)/layout.tsx`](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/layout.tsx) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and account"]
  node_landing["Landing page<br/>[page.tsx]"]
  node_login["Sign in<br/>[page.tsx]"]
  node_register["Registration<br/>[page.tsx]"]
end

subgraph group_learning["Learning experience"]
  node_subjects["Subject catalog<br/>[page.tsx]"]
  node_subject["Subject chapters<br/>[page.tsx]"]
  node_chapter["Chapter study<br/>[page.tsx]"]
  node_tutor["AI tutor<br/>[page.tsx]"]
  node_tutor_api["Tutor API<br/>[route.ts]"]
  node_skills["Skill development<br/>[page.tsx]"]
end

subgraph group_progress["Progress and planning"]
  node_planner["Study planner<br/>[page.tsx]"]
  node_revision["Revision<br/>[page.tsx]"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_analytics["Analytics<br/>[page.tsx]"]
  node_achievements["Achievements<br/>[page.tsx]"]
  node_leaderboard["Leaderboard<br/>[page.tsx]"]
end

subgraph group_shared["Shared application layer"]
  node_shell["App shell<br/>[layout.tsx]"]
  node_sidebar["Navigation sidebar<br/>[Sidebar.tsx]"]
  node_settings["Settings<br/>[page.tsx]"]
  node_auth_store[("Auth state<br/>[store.ts]")]
  node_mock_data["Learning demo data<br/>[mockData.ts]"]
end

node_student(("Student"))

node_student -->|"opens"| node_landing
node_student -->|"signs in"| node_login
node_student -->|"registers"| node_register
node_landing -->|"reads state"| node_auth_store
node_login -->|"authenticates"| node_auth_store
node_register -->|"creates user"| node_auth_store
node_shell -->|"reads state"| node_auth_store
node_shell -->|"renders"| node_sidebar
node_sidebar -->|"reads state"| node_auth_store
node_student -->|"uses app"| node_shell
node_dashboard -->|"links to"| node_subjects
node_dashboard -->|"links to"| node_planner
node_subjects -->|"reads content"| node_mock_data
node_subject -->|"reads chapters"| node_mock_data
node_chapter -->|"reads study content"| node_mock_data
node_skills -->|"reads domains"| node_mock_data
node_tutor -.->|"may call"| node_tutor_api
node_planner -->|"reads state"| node_auth_store
node_dashboard -->|"reads state"| node_auth_store
node_dashboard -->|"reads content"| node_mock_data
node_analytics -->|"reads metrics"| node_mock_data
node_achievements -->|"reads state"| node_auth_store
node_achievements -->|"reads content"| node_mock_data
node_leaderboard -->|"reads state"| node_auth_store
node_leaderboard -->|"reads rankings"| node_mock_data
node_settings -->|"reads state"| node_auth_store

click node_landing "https://github.com/burrarohith66/neuronxai/blob/main/src/app/page.tsx"
click node_login "https://github.com/burrarohith66/neuronxai/blob/main/src/app/login/page.tsx"
click node_register "https://github.com/burrarohith66/neuronxai/blob/main/src/app/register/page.tsx"
click node_shell "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/layout.tsx"
click node_sidebar "https://github.com/burrarohith66/neuronxai/blob/main/src/components/Sidebar.tsx"
click node_subjects "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/academics/page.tsx"
click node_subject "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/academics/%5BsubjectId%5D/page.tsx"
click node_chapter "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/academics/%5BsubjectId%5D/%5BchapterId%5D/page.tsx"
click node_tutor "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/ai-tutor/page.tsx"
click node_tutor_api "https://github.com/burrarohith66/neuronxai/blob/main/src/app/api/ai-tutor/route.ts"
click node_skills "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/skills/page.tsx"
click node_planner "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/planner/page.tsx"
click node_revision "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/revision/page.tsx"
click node_dashboard "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/dashboard/page.tsx"
click node_analytics "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/analytics/page.tsx"
click node_achievements "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/achievements/page.tsx"
click node_leaderboard "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/leaderboard/page.tsx"
click node_settings "https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/settings/page.tsx"
click node_auth_store "https://github.com/burrarohith66/neuronxai/blob/main/src/lib/store.ts"
click node_mock_data "https://github.com/burrarohith66/neuronxai/blob/main/src/lib/mockData.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_landing,node_login,node_register toneBlue
class node_subjects,node_subject,node_chapter,node_tutor,node_tutor_api,node_skills toneAmber
class node_planner,node_revision,node_dashboard,node_analytics,node_achievements,node_leaderboard toneMint
class node_shell,node_sidebar,node_settings,node_auth_store,node_mock_data toneRose
class node_student toneIndigo
```

## Components

### Entry and account

- [Landing page](https://github.com/burrarohith66/neuronxai/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Sign in](https://github.com/burrarohith66/neuronxai/blob/main/src/app/login/page.tsx): `src/app/login/page.tsx`
- [Registration](https://github.com/burrarohith66/neuronxai/blob/main/src/app/register/page.tsx): `src/app/register/page.tsx`

### Learning experience

- [Subject catalog](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/academics/page.tsx): `src/app/(app)/academics/page.tsx`
- [Subject chapters](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/academics/%5BsubjectId%5D/page.tsx): `src/app/(app)/academics/[subjectId]/page.tsx`
- [Chapter study](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/academics/%5BsubjectId%5D/%5BchapterId%5D/page.tsx): `src/app/(app)/academics/[subjectId]/[chapterId]/page.tsx`
- [AI tutor](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/ai-tutor/page.tsx): `src/app/(app)/ai-tutor/page.tsx`
- [Tutor API](https://github.com/burrarohith66/neuronxai/blob/main/src/app/api/ai-tutor/route.ts): `src/app/api/ai-tutor/route.ts`
- [Skill development](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/skills/page.tsx): `src/app/(app)/skills/page.tsx`

### Progress and planning

- [Study planner](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/planner/page.tsx): `src/app/(app)/planner/page.tsx`
- [Revision](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/revision/page.tsx): `src/app/(app)/revision/page.tsx`
- [Dashboard](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/dashboard/page.tsx): `src/app/(app)/dashboard/page.tsx`
- [Analytics](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/analytics/page.tsx): `src/app/(app)/analytics/page.tsx`
- [Achievements](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/achievements/page.tsx): `src/app/(app)/achievements/page.tsx`
- [Leaderboard](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/leaderboard/page.tsx): `src/app/(app)/leaderboard/page.tsx`

### Shared application layer

- [App shell](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/layout.tsx): `src/app/(app)/layout.tsx`
- [Navigation sidebar](https://github.com/burrarohith66/neuronxai/blob/main/src/components/Sidebar.tsx): `src/components/Sidebar.tsx`
- [Settings](https://github.com/burrarohith66/neuronxai/blob/main/src/app/(app)/settings/page.tsx): `src/app/(app)/settings/page.tsx`
- [Auth state](https://github.com/burrarohith66/neuronxai/blob/main/src/lib/store.ts): `src/lib/store.ts`
- [Learning demo data](https://github.com/burrarohith66/neuronxai/blob/main/src/lib/mockData.ts): `src/lib/mockData.ts`

### Other components

- **Student**

## Connections

- Student → Landing page: opens (evidence: `src/app/page.tsx`)
- Student → Sign in: signs in (evidence: `src/app/login/page.tsx`)
- Student → Registration: registers (evidence: `src/app/register/page.tsx`)
- Landing page → Auth state: reads state (evidence: `src/app/page.tsx`)
- Sign in → Auth state: authenticates (evidence: `src/app/login/page.tsx`)
- Registration → Auth state: creates user (evidence: `src/app/register/page.tsx`)
- App shell → Auth state: reads state (evidence: `src/app/(app)/layout.tsx`)
- App shell → Navigation sidebar: renders (evidence: `src/app/(app)/layout.tsx`)
- Navigation sidebar → Auth state: reads state (evidence: `src/components/Sidebar.tsx`)
- Student → App shell: uses app (evidence: `src/app/(app)/layout.tsx`)
- Dashboard → Subject catalog: links to (evidence: `src/app/(app)/dashboard/page.tsx`)
- Dashboard → Study planner: links to (evidence: `src/app/(app)/dashboard/page.tsx`)
- Subject catalog → Learning demo data: reads content (evidence: `src/app/(app)/academics/page.tsx`)
- Subject chapters → Learning demo data: reads chapters (evidence: `src/app/(app)/academics/[subjectId]/page.tsx`)
- Chapter study → Learning demo data: reads study content (evidence: `src/app/(app)/academics/[subjectId]/[chapterId]/page.tsx`)
- Skill development → Learning demo data: reads domains (evidence: `src/app/(app)/skills/page.tsx`)
- AI tutor → Tutor API: may call
- Study planner → Auth state: reads state (evidence: `src/app/(app)/planner/page.tsx`)
- Dashboard → Auth state: reads state (evidence: `src/app/(app)/dashboard/page.tsx`)
- Dashboard → Learning demo data: reads content (evidence: `src/app/(app)/dashboard/page.tsx`)
- Analytics → Learning demo data: reads metrics (evidence: `src/app/(app)/analytics/page.tsx`)
- Achievements → Auth state: reads state (evidence: `src/app/(app)/achievements/page.tsx`)
- Achievements → Learning demo data: reads content (evidence: `src/app/(app)/achievements/page.tsx`)
- Leaderboard → Auth state: reads state (evidence: `src/app/(app)/leaderboard/page.tsx`)
- Leaderboard → Learning demo data: reads rankings (evidence: `src/app/(app)/leaderboard/page.tsx`)
- Settings → Auth state: reads state (evidence: `src/app/(app)/settings/page.tsx`)