avidraghav / spacedawn

Space Dawn is a demo app built to demonstrate the use of Mutli-Module Clean MVVM Architecture with Jetpack Compose by following Material-3 guidelines along with other MAD libraries such as Dagger-Hilt, Room Database, Coroutines, Navigation, WorkManager etc. for building Android Apps

Space Dawn

Space Dawn is a demo app built to demonstrate the use of Mutli-Module Clean MVVM Architecture with Jetpack Compose by following Material-3 guidelines along with other MAD libraries. The app lets a user Save reminders/alarms for the upcoming Rocket Launches From around the world.

You can download the app from Playstore or download the apk from 🚀

🛠 Built With

Architecture	Multi-Module Clean MVVM Architecture
UI Framework	Jetpack Compose
💉 DI	Dagger-Hilt
🌐 Networking	Retrofit + Moshi
💾 Local Database	Room Database
🧭 Navigation	Compose Destinations Navigation
🏗️ Persistent Background Work	WorkManager + AlarmManager
🧵 Asynchronous Work	Coroutines
🖼️ Image Loading	Coil

🎥 Working Demo

demo_video.mov	The reminder in the demo fires right away and this is purposeful as to demonstrante the functionality.

📱 Screenshots (Dark and Light Theme)

Upcoming Launches Screen	Reminders Screen	Notification Sample
Upcoming Launches Screen	Reminders Screen	Notification Sample

🏗️ Architecture Diagram

✔️ Tests

Tests are continuosly being written. Check the test and androidTest source sets for already available test cases.

🚀 The app uses Launch Library 2 API for getting upcoming Rocket Launches.

License

Copyright 2023 Raghav Aggarwal

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

spacedawn's Issues

Integrate Jacoco Plugin for Test Coverage

Integrate the Jacoco Gradle plugin to check the code covered by test cases in all modules

Implement Dark and Light Mode

Run Instrumentation Tests on CI

Modify the Android-CI file under .github/workflows folder to run Instrumented tests on CI.

Implement Splash Screen

Implement Splash Screen by using the AndroidX Splash Screen library

The code which handles Permissions for the 'Set Reminder' Feature is not scalable

There are issues with code which handles permissions for the Set Reminder Feature to work which are

1. The code is not scalable, in future if any further permission is needed from a user to make the Set Reminder feature work then the lot of changes will be needed to done in both domain and UI layer.

The code is written the way it is because I couldn't devise a scalable way for asking the user for Runtime and Special Permissions in tandem. Scalable way to handle multiple runtime permission can be done via a queue data structure but the way a user grants a Special Permission is different from the way he grants a runtime permission hence the whole fiasco.

Handle Device-boot scenario for Launch Reminders

If the device is booted then all the reminders set will get cancelled as this is the default behaviour for any reminder set via AlarmManager API.
Intercept the ACTION_BOOT_COMPLETED broadcast from within the app and use it to again set the reminders.

Implement Navigation Drawer