ShareACab
An app for sharing cab with college students
Description
Usually, after exams or when the mid-sem break begins, there is a large surge of people going back to their respective hometown by air/railways. This journey involves an initial travel where the person takes a cab to the IGI Airport or the New Delhi Railway station. A lot of times, people are forced to travel solo, if there isn't anyone he/she knows traveling at a similar time. Also, this leads to shortage of cabs nearby and increase in waiting time. Had there been a student of IIT-D with whom the cab could have been shared, the fares would also be split and the waiting time will also reduce. Another thing is that girls prefer not to travel alone in Cabs in Delhi, so that problem will also be solved by this app.
App Preview
Directory Layout
ShareACab
+--- README, LICENSE // basic information
+--- assets // contains all assets like images for project
|
+--- lib
+--- models
+--- alltrips.dart // (WILL BE REMOVED LATER)
+--- requestdetails.dart // Request Model
+--- user.dart // User Model
+--- screens
+--- authenticate
+--- authenticate.dart // for toggling between sign in and register
+--- forgotpass.dart // forgot password screen
+--- register.dart // register user screen
+--- sign_in.dart // sign in screen
+--- verified_email_check.dart // check if user verified screen
+--- chatscreen // handles the chating section
+--- chat_database
+--- chatservices.dart
+--- database.dart
+--- chat_widgets
+--- chat_bubbles.dart
+--- chat_tile.dart
+--- chat_users_list.dart
+--- message.dart
+--- new_message.dart
+--- chat_screen.dart
+--- groupdetailscreen // handles the screen when user clicks on a card on dashboard
+--- appbar.dart // group details page appbar
+--- ended_group_details.dart // group details page for ended rides
+--- groupdetails.dart // group details page
+--- groupscreen // handles the screen when user is in a cab/group
+--- group.dart // shows the current group details
+--- editgroup.dart // edit group details page
+--- notifications // handles notification screen
+--- services
+--- database.dart // handles database for notifications
+--- notifservice.dart // service file for calling database functions relevant to notifications
+--- widgets
+--- notifslist.dart // displays list of notifications
+--- notiftile.dart // UI for notification tile
+--- notifications.dart // notification page
+--- profile
+--- userprofile.dart // handles user profile screen
+--- requests // handles the requests of users screen
+--- myrequests.dart // displays Ended rides
+--- createtrip.dart // the screen for creating a new group
+--- dashboard.dart // handles dashboard
+--- edituserdetails.dart // handles edit user details page
+--- filter.dart // handles filter service
+--- help.dart // handles help/FAQ screen
+--- messages.dart // messages screen
+--- rootscreen.dart // handles navigation services
+--- settings.dart // settings page to set dark mode
+--- tripslist.dart // displays the list of trips on dashboard
+--- wrapper.dart // handles the routing when a user is logged in
+--- services
+--- auth.dart // handles all authentication related services
+--- database.dart // the PRIMARY database service which handles everything
+--- trips.dart // for calling a function purposes
+--- shared
+--- loading.dart // the loading screen
+--- main.dart
|
+--- functions // Firebase Functions Folder: automatically run backend code in response to events
| // triggered by Firebase features and HTTPS requests
|
+--- etc
What's working:
-
Authentication
- Sign up/Sign in using email and password. The user also needs to verify their email ID before logging in. Also given an option to reset password.
- Frontend/Backend by @kshitijalwadhi
-
Curved Navbar
- Curved Navbar to navigate between various screens
- UI and dummy screens implemented by @Deepanshu-Rohilla
- Logic by @kshitijalwadhi
-
Dashboard
- Displaying the list of ongoing cabs/groups here. If the user taps on a card, the user is navigated to a screen which shows an overview of the group. On the group page, if the person clicks on join now, he's added to that group and is navigated to a screen where the details of the group are shown. There is also a floating action button which can be used in two ways, if the person is currently not in a group, by clicking the button he can create a new one, whereas if the user is already in a group, the button navigates him/her to the group details page. There is also an option to leave the group in the group details page. The admin of the group can also edit the details of the group.
- UI by @Ishaan21
- Backend/Logic by @kshitijalwadhi
-
Ended Rides
- Displays completed rides of the user.
- The user can tap on the cards to view the details.
- Implemented by @kshitijalwadhi
-
Settings
- Currently has the ability to switch to dark mode and also report bugs.
- Implemented by @kshitijalwadhi
-
Chatting Functionality
- Whenever a group is created, a chatbox is also created where the members of that group can chat amongst each other.
- UI by @Ishaan21 and @Deepanshu-Rohilla
- Backend/logic by @Ishaan21
-
Profile Page
- Displaying the user details on this page and also an option to edit them on the navbar.
- UI by @Deepanshu-Rohilla and @kshitijalwadhi
- Backend/Logic by @kshitijalwadhi
-
Filter Page
- Rides on the dashboard can be filtered according to destination and privacy setting.
-
Request only groups
- There is also a facility to create private groups which require an invite to be sent to the admin of the group and the admin needs to accept that invitation to allow the user to get in the group. This invite will be present in the Notifications screen and can be accepted/declined from there itself.
Bugs:
- You tell us.
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. Check CONTRIBUTING.md for contribution rules
These were the settings available in my IDE, hence some of the code has been reformatted when I used Ctrl+Alt+L. Other than that I have added snackbar , although I had some issues figuring out the context to use with scaffold considering I am new so if any changes are required please tell me, and if I have missed any catch phrase with error in the code where snackbar wasn't already present or added by me. I can also upload .txt file if needed which mentions all the files in which I have made a change.
1 Jan 3, 2022
3.4k Dec 30, 2022
237 Dec 30, 2022
280 Nov 23, 2022
6 Nov 21, 2022
6 Mar 16, 2022
2 Jan 17, 2022
2 Dec 22, 2021
3 Jan 10, 2022
2 Sep 24, 2022
13 Nov 15, 2022
78 Dec 30, 2022
18 Sep 13, 2022
844 Jan 1, 2023
58 Jan 5, 2023
4 Dec 6, 2022
17 Oct 14, 2022
10 Dec 20, 2022
5 Nov 9, 2022