{"id":21759335,"url":"https://github.com/sanjib-sen/ride-with-bracu","last_synced_at":"2025-10-07T18:31:53.566Z","repository":{"id":64662867,"uuid":"570681920","full_name":"sanjib-sen/ride-with-bracu","owner":"sanjib-sen","description":"A Ride Sharing app only for BRAC University Students which focuses on cost, convenience and safety","archived":false,"fork":false,"pushed_at":"2023-10-25T03:24:39.000Z","size":2729,"stargazers_count":3,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-11-26T11:46:18.094Z","etag":null,"topics":["bracu","next-auth","nextjs","prisma","rideshare","ridesharing","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://ride-with-bracu.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sanjib-sen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2022-11-25T20:07:57.000Z","updated_at":"2024-03-08T19:17:04.000Z","dependencies_parsed_at":"2023-12-18T06:47:28.791Z","dependency_job_id":null,"html_url":"https://github.com/sanjib-sen/ride-with-bracu","commit_stats":{"total_commits":52,"total_committers":2,"mean_commits":26.0,"dds":"0.019230769230769273","last_synced_commit":"87d0056250cfebcbf7faea0a1d3a062a3d08958b"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanjib-sen%2Fride-with-bracu","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanjib-sen%2Fride-with-bracu/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanjib-sen%2Fride-with-bracu/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sanjib-sen%2Fride-with-bracu/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sanjib-sen","download_url":"https://codeload.github.com/sanjib-sen/ride-with-bracu/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235651979,"owners_count":19024171,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bracu","next-auth","nextjs","prisma","rideshare","ridesharing","tailwindcss","typescript"],"created_at":"2024-11-26T11:30:50.912Z","updated_at":"2025-10-07T18:31:48.093Z","avatar_url":"https://github.com/sanjib-sen.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Ride with BRACU\n\n- [Ride with BRACU](#ride-with-bracu)\n  - [Explaination](#explaination)\n  - [Screenshots (Android)](#screenshots-android)\n  - [Features](#features)\n  - [How to Build](#how-to-build)\n  - [Unit Tests](#unit-tests)\n  - [Deployment](#deployment)\n  - [Tech Stacks](#tech-stacks)\n  - [Notable Achievement](#notable-achievement)\n  - [Future Roadmap](#future-roadmap)\n  - [Contact](#contact)\n\nRide with BRACU is a Ride Sharing app only for BRAC University Students which focuses on cost, convenience and safety. It is not a direct competitor of traditional ride sharing apps such as Uber, Lyft, Pathao, Obhai, etc. rather an extension to make the ride sharing process of those apps cheaper and safer.\n\nIf you are a BRAC University student, you can use the live version from [ride-with-bracu.vercel.app](https://ride-with-bracu.vercel.app)\n\n## Explaination\n\nSuppose you are a BRAC Univsersity Student and you live in Shyamoli, Dhaka. You are late for your University and you want to use a Ride Sharing app like Uber. But the cost is too much. So, you thought:\n\n\u003e I wish I knew someone from Shyamoli so that I could share my Uber Ride with him/her.\n\nThis app will help you to find every students of BRACU from Dhaka City who are also looking for a Ride and connect with them. In that way, you can communicate with your university mate, share your ride and split the fare. Which means:\n\n- \\+ Safety\n- \\- Money\n\n## Screenshots (Android)\n\n\u003cp float=\"left\" align=\"middle\"\u003e\n  \u003cimg src=\"screenshots/login.jpg\" width=\"100\" height=\"220\"/\u003e\n  \u003cimg src=\"screenshots/profile.jpg\" width=\"100\" height=\"220\" /\u003e\n  \u003cimg src=\"screenshots/searchInput.jpg\" width=\"100\" height=\"220\" /\u003e\n  \u003cimg src=\"screenshots/search.jpg\" width=\"100\" height=\"220\" /\u003e\n\u003c/p\u003e\n\nFor Desktop Screenshots Please visit [Desktop Screenshots](/screenshots/desktop/README.md)\n\n## Features\n\n- Strict Sign in with BRACU G-Suite Email\n- Ability to save Whatsapp Voice Call Link, Facebook Link, Messenger Link for better communication\n- Ability to save default location for faster user experience\n- Responsive UI (Desktop, Mobile and Tablet)\n- Can be used as a Web-app\n- Ability to see users who are looking for partners\n- Searching state will automatically be turned off in case of 30 minutes of inactivity\n- Can be easily converted to React Native / Expo and use as a native Android / iOS app\n- Unit Tests\n\n## How to Build\n\n- Copy `.env.example` as `.env`\n- In the `.env` file enter your [Google Cloud credentials](https://console.cloud.google.com/apis/credentials)\n- In the `prisma/schema.prisma` comment line no 10, 11 and uncomment line no 14, 15 (Hint is given in the file).\n- Run the following commands\n\n    ```bash\n    npm install \u0026\u0026\n    npx prisma migrate dev \u0026\u0026\n    npx prisma db push \u0026\u0026\n    npm run dev\n    ```\n\nThen open [http://localhost:3000](http://localhost:3000) with a browser to see the result.\n\n## Unit Tests\n\nWe are using [playwright](https://playwright.dev) for unit testing as per [NextJS's suggestion](https://nextjs.org/docs/testing#playwright)\n\nRun\n\n```bash\nnpx playwright install \u0026\u0026 npm run test:e2e\n```\n\n## Deployment\n\n[Vercel](http://vercel.com/) is recommended for deployment.\n\nBefore deploying to Vercel, Run\n\n```bash\nnpm run vercel-build\n```\n\n## Tech Stacks\n\n- [NextJS](https://nextjs.org/) (Version 13.1 with [app directory](https://beta.nextjs.org/docs/routing/fundamentals#the-app-directory) enabled)\n- [TailwindCSS](https://tailwindcss.com/) for Custom CSS Styling\n- [SWR](https://swr.vercel.app/) for fetching\n- [Prisma](https://www.prisma.io/) for DB Migration\n- [PostgreSQL](https://www.postgresql.org/) as Backend DB\n- [NextAuth](https://next-auth.js.org/) for Authentication (Mainly Google Auth)\n- [TypeScript](https://www.typescriptlang.org/) for Type Safety\n- [ReactJS](https://reactjs.org/) as JavaScript Library\n- [Vercel](https://vercel.com/) for frontend deployment\n- [Railway](https://railway.app/) for backend deployment\n- [Eslint](https://eslint.org/) for linting\n- [Prettier](https://prettier.io/) as a code formatter\n- [Playwright](https://playwright.dev/) for end-to-end unit tests\n\n## Notable Achievement\n\nBefore sending the data to the DB, I have used sessionStorage as a middleware for fecthing and sending data (cache). This reduces the need of using frequent DB queries as well as improved the performance by 10x.\n\n## Future Roadmap\n\n- Google Map integration for showing location and roads\n- GPS integration for grabbing current location\n- Convert to React Native after final build\n- Better UI/UX\n- You tell me\n\n## Contact\n\nPlease mail to [sksenonline@gmail.com](mailto:sksenonline@gmail.com)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanjib-sen%2Fride-with-bracu","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsanjib-sen%2Fride-with-bracu","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsanjib-sen%2Fride-with-bracu/lists"}