SaadAAkash / COVID-19-Bangladesh-Android

COVID-19-Bangladesh-Android

Palao Corona

An end to end tool & an awareness app with COVID-19 Facts, Mythbusters & Support to eradicate the language & context barrier of misinformation that's been spreading on social media & thus creating mass panic here in Bangladesh. Palao Corona, the app along with its website & social media support group, is a part of our movement against the COVID-19 outbreak which aims to prepare people to fight against the CoronaVirus by providing the necessary information, strategy and support.

It's built using Kotlin with layers-by-features packaging, MVVM architecture & other standard practices in Native Android development.

Architecture Used

App Screenshots

Features

• Easy bilingual support with user navigation
• Continuous slider with graphic illustrations for myth busters, in both languages
• Information portal about COVID-19 and visualizations of how it spreads
• Free COVID-19 risk assessment test
• Firebase Realitime Database integration
• Information portal which fetches most recent news for credible news sources, both in Bangla & English, from our own backend API
• Illustration section for basic DOs and DON'Ts
• Illustration section for explaining the concept of Quarantine in local, contextual and comprehensive contents
• FAQ section with bilingual support
• A portal for Live Updates focusing only on Bangladesh, fetching data from open-sourced data sources, Management Information System (MIS) unit of the Directorate General of Health Services (DGHS), Bangladesh and other leading news paper live portals - all with proper attributions, references and credits
• A portal for emergecncy support, one-tap call features and developer contributor lists
• Other native android utilities such as Internet Connectivity check, Language and numeric utitilites, animations, transitions, etc

Built With

• Android Studio 3.6.1. The latest version can be downloaded from here
• Build gradle 3.6.1
• Android SDK 29
• Kotlin Version 1.3.70

Install the apk

Go to the following link to download the app, if we continue the support for the domain and our movement.

Contributing

Directory Structure

The following is a high level overview of relevant files and folders.

COVID-19-Bangladesh-Android/
├── app/
│   └── src/     
│       └── main/
│           ├── java/xyz/palaocorona
│           │	├── base
│           │	│ 	├── data
│           │	│	├── ui 
│           │	│	└── BaseApplication.kt
│           │	├── data
│           │	│ 	└── ...
│           │	├── di
│           │	│ 	├── annotations
│           │	│	├── components
│           │	│	└── modules
│           │	├── services
│           │	├── ui
│           │	│	├── dialogs 
│           │	│	└── features
│           │	│ 		└── ...
│           │	└── util
│           │	 	└── ...
│           ├── res/
│           └── AndroidManifest.xml
├── gradle/ 
│   └── wrapper/      
│       ├── gradle-wrapper.jar
│       └── gradle-wrapper.properties
├── README.md
├── build.gradle
├── gradle.properties
└── settings.gradle

Build Instructions

• After cloning the project, checkout to the branch docs and copy the app-level build.gradle file from the directory path app/build.gradle. Add it to your local project.

• Connect your app to Firebase, Create a Database and add Firebase Android config files and the essentials (google-services.json). For more information, please visit Installation & Setup on Android

• [Optional] Create a directory drawable in the path app/src/main/res and add your own demo graphics, which have been removed to protect the content privacy of this movement, Palao Corona. Alternatively, comment out the codes where they have been used to run the demo app

• [Optional] Create a directory assests in the path app/src/main/ and put your animation files in it. Alternatively, comment out the codes where they have been used to run the demo app

File Uses

• <PROJECT_ROOT>\build.gradle : Top-level build file with configuration options common to all sub-projects/modules
• <PROJECT_ROOT>\app\build.gradle : Gradle specific for app module with libraries used
  • If you use another module in your project, as a local library, you would have another build.gradle file: <PROJECT_ROOT>\module\build.gradle

Create a branch

1. git checkout master from any folder in your local COVID-19-Bangladesh-Android repository
2. git pull origin master to ensure you have the latest main code
3. git checkout -b the-name-of-my-branch (replacing the-name-of-my-branch with a suitable name) to create a branch

Make the change

1. Change/Add the codes
2. Save the files and check the codes if it has successfl build config.

Test the change

1. If possible, test the codes the way you want.

Push it

1. git add -A && git commit -m "My message" (replacing My message with a commit message, such as Fixed App Crash or Added App Crash 28 Fix) to stage and commit your changes
2. git push my-fork-name the-name-of-my-branch
3. Go to the COVID-19-Bangladesh-Android and you should see recently pushed branches.
4. Follow GitHub's instructions and open up a pull request.
5. If possible, include screenshots of visual changes.

Libraries Used

• Glide
• SDP
• SSP
• Dexter
• Lottie
• Android Image Slider
• Logger
• Android PinView/OtpView
• CircleImageView

Contributors

1. Android - App
   1. Saad A Akash
   2. Shafayat Hossain Khan
2. Back End - API and Data Pipeline
   1. Manash Mandal
   2. Sihan tawsik
3. Front End - Landing Page
   1. YAS-opensource

License

MIT License

Copyright (c) 2020 Palao Corona

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.