# shanilka-yapa/acadex architecture

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

- Interactive diagram: https://gitdiagram.com/shanilka-yapa/acadex
- Repository: https://github.com/shanilka-yapa/acadex

## Overview

Acadex appears to be a cross-platform academic organizer: users can view a dashboard and manage attendance, GPA, timetables, and profile information. The tree also indicates local database support and feature-specific models. The README is empty and no Dart source was excerpted, so links among the app shell, feature screens, models, and persistence are shown only as unverified; their exact runtime routing and data flow cannot be confirmed.

Main entry points: [`acadex/lib/dashboard/dashboard.dart`](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/dashboard/dashboard.dart) (Dashboard), [`acadex/lib/gpa/gpa.dart`](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/gpa.dart) (GPA tools), [`acadex/lib/attendance/attendance_page.dart`](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/attendance_page.dart) (Attendance), [`acadex/lib/database/database.dart`](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/database/database.dart) (Local database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_entry["App entry<br/>[main.dart]"]
  node_shell["App shell<br/>[app.dart]"]
  node_dashboard["Dashboard<br/>[dashboard.dart]"]
end

subgraph group_academics["Academic tools"]
  node_attendance["Attendance"]
  node_module_page["Module view<br/>[module_page.dart]"]
  node_attendance_model["Attendance data"]
  node_lecture_model["Lecture data<br/>[lecture_model.dart]"]
  node_gpa["GPA tools<br/>[gpa.dart]"]
  node_semester["Semester view<br/>[semester_page.dart]"]
  node_gpa_model["GPA data"]
  node_semester_model["Semester data"]
  node_grade_points["Grade points<br/>[grade_points.dart]"]
  node_timetable["Timetable<br/>[timetable.dart]"]
  node_timetable_model["Timetable data"]
end

subgraph group_personal["Personal data"]
  node_profile["Profile<br/>[profile_page.dart]"]
  node_profile_model["Profile data<br/>[profile_model.dart]"]
end

subgraph group_storage["Local storage"]
  node_database[("Local database<br/>[database.dart]")]
end

node_user(("User"))

node_user -.->|"opens"| node_entry
node_entry -.->|"starts"| node_shell
node_shell -.->|"shows"| node_dashboard
node_dashboard -.->|"opens"| node_attendance
node_dashboard -.->|"opens"| node_gpa
node_dashboard -.->|"opens"| node_timetable
node_dashboard -.->|"opens"| node_profile
node_attendance -.->|"opens"| node_module_page
node_attendance -.->|"uses"| node_attendance_model
node_module_page -.->|"uses"| node_lecture_model
node_gpa -.->|"opens"| node_semester
node_gpa -.->|"uses"| node_gpa_model
node_gpa -.->|"uses"| node_grade_points
node_semester -.->|"uses"| node_semester_model
node_timetable -.->|"uses"| node_timetable_model
node_profile -.->|"uses"| node_profile_model
node_attendance -.->|"persists"| node_database
node_gpa -.->|"persists"| node_database
node_timetable -.->|"persists"| node_database
node_profile -.->|"persists"| node_database

click node_entry "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/main.dart"
click node_shell "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/app.dart"
click node_dashboard "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/dashboard/dashboard.dart"
click node_attendance "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/attendance_page.dart"
click node_module_page "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/module_page.dart"
click node_attendance_model "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/attendance_module_model.dart"
click node_lecture_model "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/lecture_model.dart"
click node_gpa "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/gpa.dart"
click node_semester "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/semester_page.dart"
click node_gpa_model "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/gpa_module_model.dart"
click node_semester_model "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/semester_model.dart"
click node_grade_points "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/grade_points.dart"
click node_timetable "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/timetable/timetable.dart"
click node_timetable_model "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/timetable/timetable_model.dart"
click node_profile "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/profile/profile_page.dart"
click node_profile_model "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/profile/profile_model.dart"
click node_database "https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/database/database.dart"

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_entry,node_shell,node_dashboard,node_user toneBlue
class node_attendance,node_module_page,node_attendance_model,node_lecture_model,node_gpa,node_semester,node_gpa_model,node_semester_model,node_grade_points,node_timetable,node_timetable_model toneAmber
class node_profile,node_profile_model toneMint
class node_database toneRose
```

## Components

### Application

- [App entry](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/main.dart): `acadex/lib/main.dart`
- [App shell](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/app.dart): `acadex/lib/app.dart`
- [Dashboard](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/dashboard/dashboard.dart): `acadex/lib/dashboard/dashboard.dart`

### Academic tools

- [Attendance](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/attendance_page.dart): `acadex/lib/attendance/attendance_page.dart`
- [Module view](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/module_page.dart): `acadex/lib/attendance/module_page.dart`
- [Attendance data](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/attendance_module_model.dart): `acadex/lib/attendance/attendance_module_model.dart`
- [Lecture data](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/attendance/lecture_model.dart): `acadex/lib/attendance/lecture_model.dart`
- [GPA tools](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/gpa.dart): `acadex/lib/gpa/gpa.dart`
- [Semester view](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/semester_page.dart): `acadex/lib/gpa/semester_page.dart`
- [GPA data](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/gpa_module_model.dart): `acadex/lib/gpa/gpa_module_model.dart`
- [Semester data](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/semester_model.dart): `acadex/lib/gpa/semester_model.dart`
- [Grade points](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/gpa/grade_points.dart): `acadex/lib/gpa/grade_points.dart`
- [Timetable](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/timetable/timetable.dart): `acadex/lib/timetable/timetable.dart`
- [Timetable data](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/timetable/timetable_model.dart): `acadex/lib/timetable/timetable_model.dart`

### Personal data

- [Profile](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/profile/profile_page.dart): `acadex/lib/profile/profile_page.dart`
- [Profile data](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/profile/profile_model.dart): `acadex/lib/profile/profile_model.dart`

### Local storage

- [Local database](https://github.com/shanilka-yapa/acadex/blob/main/acadex/lib/database/database.dart): `acadex/lib/database/database.dart`

### Other components

- **User**

## Connections

- User → App entry: opens
- App entry → App shell: starts
- App shell → Dashboard: shows
- Dashboard → Attendance: opens
- Dashboard → GPA tools: opens
- Dashboard → Timetable: opens
- Dashboard → Profile: opens
- Attendance → Module view: opens
- Attendance → Attendance data: uses
- Module view → Lecture data: uses
- GPA tools → Semester view: opens
- GPA tools → GPA data: uses
- GPA tools → Grade points: uses
- Semester view → Semester data: uses
- Timetable → Timetable data: uses
- Profile → Profile data: uses
- Attendance → Local database: persists
- GPA tools → Local database: persists
- Timetable → Local database: persists
- Profile → Local database: persists
