KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

inspot

★ 22 Open GitHub ↗

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.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![inSpot_shadow_logo](https://user-images.githubusercontent.com/91165689/235646017-196e01a5-2691-47ea-aa81-cb3e3d630b09.png)
# inSpot
![mobile_row_mock](https://user-images.githubusercontent.com/91165689/235646389-440d125d-4bba-48a8-bc92-ef82255610d6.png)

## 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 ![location](https://user-images.githubusercontent.com/91165689/235649924-fc8648d5-4e52-432a-83b0-e9b524dbf2fb.png)
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__ ![home_FILL0_wght400_GRAD0_opsz20](https://user-images.githubusercontent.com/91165689/235650073-faa9c21d-4453-43c8-a68a-b0bdce5e56f8.png)
icon in the bottom nav bar.
3. If you're looking for venues, click the __venues__ ![theater_comedy_FILL0_wght400_GRAD0_opsz20](https://user-images.githubusercontent.com/91165689/235650170-dddf4a0b-c510-429b-9b02-7ef831bb062f.png)
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__ ![local_activity_FILL0_wght400_GRAD0_opsz20](https://user-images.githubusercontent.com/91165689/235650265-eba58975-ae41-4136-a3ea-5eb6feb6aad9.png)
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 ![favorite_FILL0_wght400_GRAD0_opsz20](https://user-images.githubusercontent.com/91165689/235650331-aa8ec5c2-5f16-4141-8fec-170da8a3a86b.png)
. Your saved items will appear in the __Saved__ section which you can find by clicking the upper right __bookmark__ ![bookmark_FILL0_wght400_GRAD0_opsz20](https://user-images.githubusercontent.com/91165689/235650429-45498e5a-db0e-45fc-86e1-e3b7dafac9b8.png)
icon. Filter this list by events or venues.
6. See your next upcoming events in your __profile__ section by clicking on the __profile__ ![account_circle_FILL0_wght400_GRAD0_opsz20](https://user-images.githubusercontent.com/91165689/235650497-6ecc3cdc-2778-4425-9372-88f3a7bc9b42.png)
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.

![Visitors](https://api.visitorbadge.io/api/VisitorHit?user=toshydev&repo=inspot&countColor=%23BE4BDB)

inspot

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README