Skip to content

This is a carpooling (ride sharing) app built with Flutter πŸ’™ for Android and iOS

Notifications You must be signed in to change notification settings

morikeli/TuShare

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

50 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

TuShare

Mobile app screenshots

Homescreen (My Rides tab) Homescreen (Discover tab)
homescreen discovery-tab
Profile screen (light mode) Profile screen (dark mode)
profile-light-mode profile-dark-mode
Profile screen on scroll (light mode) Profile screen on scroll (dark mode)
profile-on-scroll-light-mode profile-on-scroll-dark-mode

Overview

This is a carpooling (ride sharing) mobile application developed for Android and iOS.

Techinologies used:

  • Flutter

Developer instructions


NOTE:

  • To run this project, you MUST install Flutter SDK on your machine. Refer to Flutter's documentation and follow a step-by-step guide on how you can install Flutter SDK on your OS.

  • Make sure you have installed Android Studio or a text editor of your choice - VS Code or XCode.

  • Make sure your machine supports virtualization - required to run an emulator. If it doesn't, don't worry, you can install scrcpy on your machine or use Android Studio's mirror device feature.

Scrcpy Installation guide


Installation guide for developers

  1. Git clone

Clone this repository by opening your terminal/CMD and change the current working directory to Desktop - use cd Desktop command.

    $ cd Desktop
    $ git clone https://github.com/morikeli/TuShare.git
  1. Open the cloned repository on your text editor and run this command:
    $ flutter run
  1. Make sure you have a very strong internet connection so that the necessary gradle files can be downloaded. These files are necessary to build the project apk file.

Keep in mind:

  • When building the application for the first time, it may take 10 - 15 minutes to finish the installation and build process.
  • When running the application using the flutter run command, it may take atleast a minute to install the build files on a physical device.

Contributor expectations

Incase of a bug or you wish to make a contribution, create a new branch using the git command git checkout -b <name of your branch> and create a pull request. Wait for review.

You can also open an issue using the Issues tab. The reported issue will be reviewed and a solution may be provided.

Request

Don't forget to star the repo πŸŒŸπŸ˜‰

Known issues

The app is still under development. More features will be added with time.