This is the our official submission for HackBeanPot 2025
Roadar is a application that aims to crowdsource roadside assistance. We enable this by connecting drivers who need assistance with their vehicles and mechanics willing to offer support. Drivers can create requests which are sent out to mechanics based on location in realtime using web-sockets and mechanics and accept or deny jobs on their own accord
- Apple OAuth
- Request Creation
- Live request popups
- S3 Integration
- Web Socket integration
- Profile pages
- Activity history
- Backend: Go, Fiber, Websockets
- Frontend: React Native, TypeScript, Expo SDK 52
- Database: MongoDB Atlas
Roadar DEVELOPMENT ENVIRONMENT
╭──────────────────┬─────────────────────────────────────────────────╮
│ scripts │ description │
├──────────────────┼─────────────────────────────────────────────────┤
│ backend-lint │ # Lints backend code. │
│ backend-run │ # Runs the backend server in development mode. │
│ backend-test │ # Tests backend code. │
│ database-script │ # Runs a script against the connected Database │
│ frontend-lint │ # Lints frontend code. │
│ frontend-run │ # Runs the frontend server in development mode. │
│ frontend-run-wsl │ # Runs the frontend server in tunnel mode. │
│ frontend-test │ # Runs the frontend tests. │
╰──────────────────┴─────────────────────────────────────────────────╯
This guide assumes that you are using Linux/macOS. If you are using Windows, please install WSL.
To get started, clone the repository via HTTPS by running git clone https://github.com/abhikaboy/Roadar.git.
If you'd prefer, you can clone it via SSH.
- Install Nix
curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install
- Type in computer password if prompted.
- Say yes to prompt.
- In a new terminal activate the development environment by running the following:
nix develop --impure