Just GO

Description

Just GO is a user-friendly, innovative web application that allows users explore local areas using geolocation to find places recommended by locals.

The motivation behind this project was to provide both travelers and visitors a curated, 5 stop location itinerary that allows users to explore and get to know local neighborhoods. The app's primary focus is to provide users with a manageable itinerary that can be accomplished in less than a day. To alleviate the stress of navigating through an unknown area, the app includes three key functionalities to assist the user getting from location to location: geolocation, real-time street view, and user-friendly directions. Currently, the app is specific to the Tokyo Roppongi area, but with goals to expand to more locations.

The key feature of 'Just GO' is to provide the user with the ability to navigate an unknown area by:
(1) accessing the users geolocation;
(2) updating the user's geolocation to provide a real-time street view as they navigate through a neighborhood;
(3) provide the user with up-to-date directions as their geolocation changes

How to use Just GO

The web version of the app is hosted here.

• When users open Just GO, they are presented with a screen featuring the app logo, and a buttton which turns green once the user's geolocation is updated and the connection with the server is established.

• On the next page, the users can select one of the several routes, by clicking left and right on the arow buttons on the bottom of the screen. Once the user has decided on a route, they can click the 'Just GO' button and they will be directed to the first place in the selected route.

• On this page, the users can confirm the name of the place and whether the place is open or not on that day. If they like the place, the users can click on the 'Directions to ...' button, in order to see how they can get there.

• On the navigation page, the users can see step-by-step instructions on how to get to the selected place, by clicking on the left and right arrows. As they navigate through the instructions, the street-view image will update simultanously. At any point, the user can click on the 'Refresh location' at the bottom of the screen, and the directions will be updated to start from their current location.
  After the user has reached the destination, they can select the 'I'm done here"...' button to be directed to the next place in the route.

• At the end of the route, the users are presented with a list of the places they have visited that day. They can also finish a route early, by selecting the 'End Route' button on the bottom of the screen.

Project presentation & demo

You can view the demo video of Just GO here, or watch our team presentation on Youtube.

Backend repository

The backend repository for this app can be found here.

Getting Started

For optimal results, please make sure that the Node.js version on your local machine is v16.13.2 or above.

• Clone the repositories:
  • frontend: git clone https://github.com/ARBReW/justGoFront.git
  • backend repo: git clone https://github.com/ARBReW/justGoBack.git
• Install npm packages: npm install
• Start frontend: npm run dev
• Start backend: npm start:dev

Tech-stack:

This project uses the React and Next.js frameworks. Next.js provides various features to optomize production: hybrid & static server rendering, Typescript support, smart bundling, route pre-fetching, and more with no config needed. As for design, we incorporated the Chakra UI component library to build our React application.

• React.js
• Next.js
• Chakra UI
• Typescript
• Deployment: Vercel

Contributors

• Project tech lead: Brian Lee
• Frontend developer: Ana Scuturici
• Fullstack developer & technologist: Wesley Lee
• Fullstack developer: Richard Beavis
• Fullstack developer: Roman Montoya

Acknowledgements

This project was developed during our time as students at Code Chrysalis.
A big thank you to our instructors, the staff and our cohort mates at CC for all the support during the development of our app.

Contributing

If you have a suggestion that would make our app better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".
If you like our project, please give us a star! Thank you!