/inDrive

A passenger booking ride application

Primary LanguageKotlinMIT LicenseMIT

inDrive

An enhanced passenger booking ride application. It collects the users location and tends to display nearby places that the user can visit in case he is bored.

Contributors

  • Charles Muvaka

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

Prerequisites

  • Android Studio IDE
  • SDKMan - To handle different java versions.
  • Java 11
  • Kotlin

Behaviour Driven Development

1. Getting Places

  • The application begins with collecting the users location.
  • Based on the users location, it displays to him nearby places he can visit.

To Dos

These are features that we are hoping to add in the application.

1. Displaying available routes from an origin to a destination.

  • When a user decides to have a ride from a certain place to the other, we will display to him all the availavbel routes he can use to reach his destination.
  • He will have an opportunity to decide the route he prefers.

2. Displaying traffic conditions to the user

  • For convenience we'd want to utilise all the powers of the Google places API, display to them the current road conditions they are using.

Installing

  • Fork the repo
  • Create a new branch
 $ git switch -c (improve-feature)

  • Make the required changes in the file.

  • Add changes to reflect the changes made.

  • Commit your changes.

    $ git commit -am (improve-feature)

  • Push to the branch

    $ git push origin (improve-feature)

  • Create a Pull Request

  • You can clone it it to your local machine to have it locally.

  • Clone this repository to a location in your file system.

  • Open terminal command line then navigate to the root folder of the application.

      $ git clone  https://github.com/CharlesMuvaka/inDrive.git
  $ cd ../path/to/the/file

Built With

  • Android Framework
  • Kotlin

Dependencies

  • Java
  • JetPck Compose
  • Kotlin coroutines
  • Espresso Testing Framework
  • Roboelectric Testing Framework
  • JUnit Testing Framework
  • Retrofit
  • Gson Converter
  • Firebase

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Authors

  • Charles Muvaka - Initial work - LinkedIn

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments

  • Hat tip to anyone whose code was used
  • Inspiration
  • etc