https://github.com/morikeli/tushare
This is a carpooling (ride sharing) app built with Flutter 💙 for Android and iOS
https://github.com/morikeli/tushare
android android-app android-application carpooling carpooling-application dart flutter flutter-app flutter-apps flutter-examples flutter-launcher-icons flutter-ui getx ios ios-app ios-application ride-sharing rideshare rideshare-application ridesharing-app
Last synced: 8 months ago
JSON representation
This is a carpooling (ride sharing) app built with Flutter 💙 for Android and iOS
- Host: GitHub
- URL: https://github.com/morikeli/tushare
- Owner: morikeli
- Created: 2025-01-06T21:29:55.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-09T08:49:27.000Z (about 1 year ago)
- Last Synced: 2025-05-09T09:38:22.319Z (about 1 year ago)
- Topics: android, android-app, android-application, carpooling, carpooling-application, dart, flutter, flutter-app, flutter-apps, flutter-examples, flutter-launcher-icons, flutter-ui, getx, ios, ios-app, ios-application, ride-sharing, rideshare, rideshare-application, ridesharing-app
- Language: Dart
- Homepage:
- Size: 3.25 MB
- Stars: 5
- Watchers: 2
- Forks: 2
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# TuShare
## Mobile app screenshots
| Light mode | Dark mode |
| ------------------------- | ------------------------- |
| | |
| Homescreen (My rides tab) | Homescreen (discover tab) |
|  | |
| | |
| | |
| Profile screen (light mode) | Profile screen (dark mode) |
|  |  |
| | |
| | |
| Car slots screen | Car slots screen on scroll |
|  |  |
| | |
| | |
| Car slots (Mini map) | Fullscreen map |
|  |  |
| | |
| | |
| Messages screen | Messages screen |
|  |  |
|  |  |
## Overview
This is a **carpooling (ride-sharing) mobile application** designed to provide a seamless and efficient way for users to share rides. The app connects passengers and drivers, allowing users to book or offer rides conveniently.
### **Key Features**
- **Ride booking** – Passengers can search for and book available rides.
- **Ride posting** – Drivers can list their rides, including route, time, and seat availability.
- **Real-time location tracking** – Integrated with OpenStreetMap for navigation.
- **Secure authentication** – User authentication and profile management.
- **Dynamic seat availability** – Tracks remaining seats per ride.
### **Technologies Used**
- **Frontend:** Flutter (Dart)
- **Backend:** FastAPI (Python)
- **Database:** SQLite/PostgreSQL
- **State Management:** GetX
- **Authentication:** OAuth 2.0 and JWT-based authentication
- **Maps & Navigation:** OpenStreetMap
## Developer instructions
---
**NOTE**:
* To run this project, you **MUST** install Flutter SDK on your machine. Refer to [Flutter's documentation](https://docs.flutter.dev/get-started/install) 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**
* [Install scrcpy on Windows](https://github.com/Genymobile/scrcpy/blob/master/doc/windows.md)
* [Install scrcpy on Linux](https://github.com/Genymobile/scrcpy/blob/master/doc/linux.md)
* [Install scrcpy on MacOS](https://github.com/Genymobile/scrcpy/blob/master/doc/macos.md)
---
#### 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.
```bash
cd Desktop
git clone https://github.com/morikeli/TuShare.git
```
2. Create a `.env` file and add the following environment variable.
```env
API_URL=https://tushare-ride-sharing-app.onrender.com
```
3. Open the cloned repository on your text editor and run this command:
```bash
flutter run
```
4. 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, or more dependencies on your hardware specifications such as CPU speed, or RAM, 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 ` 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.