https://github.com/toshydev/inspot
Nearby event finder which can filter events by genres and tags and informs the user about the distance as well as the time left until the start of events.
https://github.com/toshydev/inspot
events finder google-maps-api javascript jest mongodb-atlas mongoose next-auth nextjs nodejs react react-testing-library rest-api styled-components swr ticketmaster-api zustand
Last synced: 9 days ago
JSON representation
Nearby event finder which can filter events by genres and tags and informs the user about the distance as well as the time left until the start of events.
- Host: GitHub
- URL: https://github.com/toshydev/inspot
- Owner: toshydev
- License: gpl-3.0
- Created: 2023-03-31T07:58:58.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2023-08-18T13:35:24.000Z (over 1 year ago)
- Last Synced: 2025-04-04T03:11:21.122Z (about 1 month ago)
- Topics: events, finder, google-maps-api, javascript, jest, mongodb-atlas, mongoose, next-auth, nextjs, nodejs, react, react-testing-library, rest-api, styled-components, swr, ticketmaster-api, zustand
- Language: TypeScript
- Homepage: https://capstone-inspot.vercel.app/
- Size: 2.61 MB
- Stars: 22
- Watchers: 1
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# inSpot
## What is inSpot?
**inSpot** is a nearby event finder which can filter events by genres and tags and informs the user about the distance as well as the time left until the start of events.
### The idea of inSpot
Whether you're going to a __concert__, an __exhibition__, a __sports__ game or a __theater__ play, you need to know the venue address, when the event starts and where to get the tickets. Instead of looking for the information on the corresponding websites, check **inSpot**. It will give you the most important details to keep you posted on the event in just a few clicks.
## How to use
**inSpot** is easy to use and optimized for mobile devices.
1. Click on the location 
icon in the upper right corner and set your location by entering a place or let **inSpot** use the GPS function of your device.
2. Let **inSpot** recommend events near you on by clicking on the __home__ 
icon in the bottom nav bar.
3. If you're looking for venues, click the __venues__ 
icon in the bottom nav bar to see a list of venues or to search for venues by keywords in the top search bar.
4. You want to filter events by categories or keywords? Click the __events__ 
icon to get to the __explore__ page where you can set filters and/or tags in the top filter section.
5. Found an event or venue you like? Save it by clicking the heart 
. Your saved items will appear in the __Saved__ section which you can find by clicking the upper right __bookmark__ 
icon. Filter this list by events or venues.
6. See your next upcoming events in your __profile__ section by clicking on the __profile__ 
icon in the right corner of the bottom nav bar.
7. If you want to personalise your **inSpot** experience, log in with your favorite provider on the __profile__ page by As a logged in user you can rate venues by writing reviews. Are you unhappy with your review? Edit or delete it.
8. What about my data? **inSpot** only saves the data it needs to verify who you are and will never share this data with anyone. Like a blackbox! Still not safe enough? Delete your login data and reviews by clicking on the `Delete data` button in the __profile__ section.
## Development
**inSpot** uses the following Tech Stack:
- React
- Next.js
- TypeScript
- styled-components
- Jest
- React Testing Library
- Auth.js
- Node.js
- MongoDB Atlas
- mongoose
- SWR
- zustand
- Rest API
- Ticketmaster API
- Google Maps API
### Getting Started
- Clone this repository
- Set up a MongoDB server
- Get your Ticketmaster API key from [Ticketmaster API](https://developer.ticketmaster.com/products-and-docs/apis/getting-started/)
- Get your Google Maps API key from [Google API Explorer](https://developers.google.com/apis-explorer)
- Set up your own .env.local file with your API keys
- Install all dependencies with `npm install`
- Run your development server with `npm run dev`
- Server: [http://localhost:3000/](http://localhost:3000/)
- Run tests via `npm run test`
### How do I contribute?
There are many ways to contribute to **inSpot**:
- Share your thoughts in the [inSpot Discussions](https://github.com/toshydev/inspot/discussions) to share your ideas about how **inSpot** can be improved!
- Submit a typo/bug or your feature idea in [inSpot Issues](https://github.com/toshydev/inspot/issues).
- Submit a Pull Request for an existing Issue.
Whether you are a code newbie or a seasoned hacker, there's something for you!
Please read through the [Contribution Guide](https://github.com/toshydev/inspot/blob/main/CODE_OF_CONDUCT.md) ✨. There you'll find a write-up of our content standards and templates for creating your entries.
