How shayann07/to-do-list-offline works
Project type and purpose
• Type: Android mobile application (single installable APK)
• Purpose: Offline first to-do list manager using MVVM and Room
File structure
• Two Gradle modules:
– app (the main Android application)
– library (a reusable BlurView UI component)
• Inside app:
– data/local: Room database (AppDatabase.kt), DAOs, entity models
– data/repository: Repository abstraction for data access
– ui/fragments & MainActivity: Presentation layer
– ui/viewmodel: ViewModels exposing LiveData to the UI
– utils: Helper classes (AlarmManagerHelper, Notification, etc.)
• Tests:
– unit tests under app/src/test
– instrumentation tests under app/src/androidTest
• Build scripts, configuration:
– Gradle Kotlin DSL (build.gradle.kts), proguard, versions.toml
README
• Confirms MVVM, Room, LiveData, RecyclerViews
• Describes three UI categories (Morning, Afternoon, Tonight)
• Emphasizes 100% offline operation
a. Presentation Layer
– MainActivity
– UI Fragments (TodayFragment, NewReminderFragment, etc.)
– RecyclerView adapters
b. ViewModel Layer
– Single ViewModel class per screen (e.g., ViewModel.kt)
– Exposes LiveData<List<Task>>
c. Data Layer
– Repository (Repository.kt)
– Room Database (AppDatabase)
– DAO (TasksDao)
– Data models/entities (Tasks.kt)
d. Utility & External Libraries
– AlarmManagerHelper & Notification utils
– BlurView library module (external UI component)
e. Build & Test
– Gradle build system
– Unit and instrumentation test bins
Relationships & interactions
• User taps in UI (Fragments) → Fragment calls ViewModel
• ViewModel requests data from Repository
• Repository uses DAO to query/update Room DB
• DAO returns entities → Repository → ViewModel → LiveData updates UI
• Utilities invoked (AlarmManagerHelper schedules alarms via Android AlarmManager; Notification triggers system notifications)
• Library module supplies BlurView UI component used in layouts
Architectural patterns & design principles
• MVVM separation of concerns
• Repository pattern abstracts data source
• Single source of truth in Room DB
• LiveData for reactive UI updates
• Gradle modularization (app vs. library)