Political Preparedness is a mobile application that helps users stay informed about civic data and make informed decisions during elections. The app integrates with an API to retrieve candidate information and ballot data based on addresses or geolocation. Users can mark preferred candidates and store their selections. The app also provides user authentication and data storage. The UI is designed to be intuitive and visually appealing. The project includes testing and welcomes contributions.
- Retrieve civic data using addresses or geolocation
- Mark preferred candidates and store selections
- User authentication and data storage
- Intuitive and visually appealing UI
- Testing for reliability and stability
- Open to contributions
The app has the following dependencies:
- Retrofit to make api calls to an HTTP web service.
- Moshi which handles the deserialization of the returned JSON to Kotlin data objects.
- Glide to load and cache images by URL.
- Room for local database storage.
It leverages the following components from the Jetpack library:
- ViewModel
- LiveData
- Data Binding with binding adapters
- Navigation with the SafeArgs plugin for parameter passing between fragments
- Clone the repository:
git clone [repository URL]. - Open the project in Android Studio.
- Build and run the app on your preferred device.
- NOTE: In order for this project to pull data, you will need to add your API Key to the project as a value in the CivicsHttpClient. You can generate an API Key from the Google Developers Console