How kusman28/quran-flutter works
Quran Flutter is a cross-platform Quran reader focused on reproducing a consistent Mushaf-style reading experience. The documented user workflow is to open the Quran, view its pages, and navigate between pages with a slider; responsive layouts support phones, tablets, and desktops. The tree shows Quran-page and sura models, shared app configuration, and local ayah-information database code, but their runtime wiring was not sampled, so those relationships are not asserted. The native Linux and Windows startup relationships shown below are supported by source excerpts; other platform and feature details come from the README.
Main entry points: main.cpp Windows Entry · home_page.dart Reader · flutter_window.h Flutter Window Host · main.cc Linux Runner
Components 25
Quran Reading
- Reader
lib/feature/home/ui/page/home_page.dart - Home State
lib/feature/home/bloc/home_page/home_page_bloc.dart - Page Navigation
lib/feature/home/bloc/navigator/navigator_view_bloc.dart - Quran Page View
lib/feature/quran_page/widget/quran_page_widget.dart - Responsive Layout
lib/common/util/flutter_device_type.dart
Shared App Services
- App Entry
lib/main.dart - App Shell
lib/app/app.dart - Routes
lib/common/routes/route_generator.dart - App Configuration
lib/common/bloc/appconfig/appconfig_bloc.dart - Ayah Info Service
lib/common/database/ayah_info_service.dart - Database Service
lib/common/database/database_service.dart - Database Files
lib/common/database/database_file_service.dart
Quran Content
- Ayah Info Database
assets/quran-data/db/ayahinfo_1280.db - Page Model
lib/feature/quran_page/model/quran_page.dart - Sura Model
lib/feature/sura/model/sura.dart
Platform Hosts
- Linux Runner
linux/main.cc - Linux Window Config
linux/window_configuration.h - Linux Plugin Registration
linux/flutter/generated_plugin_registrant.h - Windows Entry
windows/runner/main.cpp - Flutter Window Host
windows/runner/flutter_window.h - Win32 Window
windows/runner/win32_window.cpp - Windows Run Loop
windows/runner/run_loop.h - Windows Window Config
windows/runner/window_configuration.h - Windows Plugin Registration
windows/flutter/generated_plugin_registrant.h
Other components
- Reader
Connections 12
- Reader → Reader: opens Quran
README.md - Reader → Page Navigation: navigates pages
README.md - Reader → Quran Page View: views pages
- Page Navigation → Quran Page View: selects page
- Reader → Responsive Layout: adapts layout
README.md - Linux Runner → Linux Window Config: reads settings
linux/main.cc - Linux Runner → Linux Plugin Registration: registers plugins
linux/main.cc - Windows Entry → Windows Window Config: reads settings
windows/runner/main.cpp - Windows Entry → Flutter Window Host: creates host
windows/runner/main.cpp - Windows Entry → Windows Run Loop: runs loop
windows/runner/main.cpp - Flutter Window Host → Win32 Window: extends window
windows/runner/flutter_window.h - Flutter Window Host → Windows Run Loop: uses loop
windows/runner/flutter_window.h