azizul-c / FleetView

Keep tabs on your vehicles and stay up-to-date on recall information with FleetView.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

πŸš— FleetView

FleetView helps vehicle owners and fleet managers stay on top of recalls affecting their vehicles.

πŸ“½οΈ Watch a short demo! (1m 40s)

πŸ–ΌοΈ Gallery

Desktop

Home Page

image

View a Vehicle

image

About Page

image

iPhone 12 Pro

πŸ‘€ Features

  • Vehicle addition and deletion
  • Ability to toggle the availability of a vehicle
  • View recall information for a given vehicle
  • Fully responsive across various screen sizes

🧠 How it Works

Vehicle make logos are retrieved using the Clearbit Logo API. Vehicle recall information, based on a vehicle's make, model, and year, are retrieved from the U.S. National Highway Traffic Safety Administration (NHTSA)'s Recalls API. The front-end is written in React. Dynamic routing is achieved through react-router-dom. The icons used throughout the app are part of the react-icons package. A fake REST API (JSON Server) is used as the back-end.

πŸš€ How to Deploy

Clone this repository. In the root directory of this repo, run the following scripts.

npm run server

Runs the mock back-end server.
Open http://localhost:5000 to view it in your browser.

npm start

Runs the app in the development mode.
Open http://localhost:3000 to view it in your browser.

The page will reload when you make changes.
You may also see any lint errors in the console.

πŸ™ˆ Known Issues

  • While the inputs to the form have a decent amount of validation (e.g. empty inputs aren't accepted, and inputs with leading / trailing spaces are trimmed), they're not foolproof right now. In the future, I'd like to validate whether a given make and model actually exist before adding the vehicle to the mock back-end.
  • I haven't had a chance to test this on an iPhone myself, so it's possible that the text size on iPhone is too small. I'll be able to fix that after migrating to a real back-end.
  • There was an attempt to make the mock back-end work with the app hosted on Vercel, but that didn't work. So ignore that oopsie :)
  • I'm currently making the API call to NHTSA every time a vehicle is viewed. It would be much more efficient to make the API call as soon as the vehicle is added to the database, and the results of that API call would also be entered into the database.
  • Some vehicle make logos returned by the Clearbit Logo API don't appear nicely (e.g. Mercedes-Benz, Subaru, Ford). For the problematic logos, it might be easiest to just store them in a folder in the repo and reference them from there.

πŸ™‹β€β™‚οΈ FAQ

  • Why do you ask for a vehicle's license plate and distance driven?
    • My original goal with this app was to help fleet managers keep tabs on all their vehicles. Many fleets often consist of identical vehicles, so I felt that license plates were a reasonable differentiator. As for the distance driven, I intend to eventually add oil change warnings as a feature in the app. The user would be able to specify whether they'd like oil change reminders based on time intervals or on distance driven.
  • Why are license plates and distance driven mandatory inputs?
    • They really shouldn't be, and eventually I'll probably make them optional. But for the time being, I wanted the View Vehicle page to be populated with content, so this was an easy way of doing it.

⏳ What's Next?

I'd like to migrate the application to an actual back-end, add authentication, host it somewhere, and resolve some of the issues mentioned above. But first... I need to deal with my own car's recalls πŸ˜΅β€πŸ’«

About

Keep tabs on your vehicles and stay up-to-date on recall information with FleetView.


Languages

Language:JavaScript 54.9%Language:CSS 40.2%Language:HTML 4.9%