{"id":19492680,"url":"https://github.com/toshydev/inspot","last_synced_at":"2025-04-25T20:30:28.796Z","repository":{"id":150633223,"uuid":"621704398","full_name":"toshydev/inspot","owner":"toshydev","description":"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.","archived":false,"fork":false,"pushed_at":"2023-08-18T13:35:24.000Z","size":2736,"stargazers_count":22,"open_issues_count":4,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-04T03:11:21.122Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://capstone-inspot.vercel.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/toshydev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"toshydev"}},"created_at":"2023-03-31T07:58:58.000Z","updated_at":"2024-09-30T16:20:47.000Z","dependencies_parsed_at":null,"dependency_job_id":"2757a541-1074-44c8-90e7-28a545de9ba8","html_url":"https://github.com/toshydev/inspot","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toshydev%2Finspot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toshydev%2Finspot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toshydev%2Finspot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/toshydev%2Finspot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/toshydev","download_url":"https://codeload.github.com/toshydev/inspot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250890145,"owners_count":21503441,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-11-10T21:22:32.586Z","updated_at":"2025-04-25T20:30:28.790Z","avatar_url":"https://github.com/toshydev.png","language":"TypeScript","funding_links":["https://github.com/sponsors/toshydev"],"categories":[],"sub_categories":[],"readme":"![inSpot_shadow_logo](https://user-images.githubusercontent.com/91165689/235646017-196e01a5-2691-47ea-aa81-cb3e3d630b09.png)\n# inSpot\n![mobile_row_mock](https://user-images.githubusercontent.com/91165689/235646389-440d125d-4bba-48a8-bc92-ef82255610d6.png)\n\n## What is inSpot?\n**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.\n\n### The idea of inSpot\nWhether 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.\n\n## How to use\n**inSpot** is easy to use and optimized for mobile devices. \n1. Click on the location ![location](https://user-images.githubusercontent.com/91165689/235649924-fc8648d5-4e52-432a-83b0-e9b524dbf2fb.png)\nicon in the upper right corner and set your location by entering a place or let **inSpot** use the GPS function of your device.\n2. 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)\nicon in the bottom nav bar.\n3. 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)\nicon in the bottom nav bar to see a list of venues or to search for venues by keywords in the top search bar.\n4. 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)\nicon to get to the __explore__ page where you can set filters and/or tags in the top filter section.\n5. 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)\n. 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)\nicon. Filter this list by events or venues.\n6. 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)\nicon in the right corner of the bottom nav bar.\n7. 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.\n8. 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.\n\n## Development\n**inSpot** uses the following Tech Stack:\n- React\n- Next.js\n- TypeScript\n- styled-components\n- Jest\n- React Testing Library\n- Auth.js\n- Node.js\n- MongoDB Atlas\n- mongoose\n- SWR\n- zustand\n- Rest API\n- Ticketmaster API\n- Google Maps API\n\n### Getting Started\n\n- Clone this repository\n- Set up a MongoDB server\n- Get your Ticketmaster API key from [Ticketmaster API](https://developer.ticketmaster.com/products-and-docs/apis/getting-started/)\n- Get your Google Maps API key from [Google API Explorer](https://developers.google.com/apis-explorer)\n- Set up your own .env.local file with your API keys\n- Install all dependencies with `npm install`\n- Run your development server with `npm run dev`\n- Server: [http://localhost:3000/](http://localhost:3000/)\n- Run tests via `npm run test`\n\n### How do I contribute?\n\nThere are many ways to contribute to **inSpot**:\n\n- Share your thoughts in the [inSpot Discussions](https://github.com/toshydev/inspot/discussions) to share your ideas about how **inSpot** can be improved!\n- Submit a typo/bug or your feature idea in [inSpot Issues](https://github.com/toshydev/inspot/issues).\n- Submit a Pull Request for an existing Issue.\n\nWhether you are a code newbie or a seasoned hacker, there's something for you!\n\nPlease 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.\n\n\n![Visitors](https://api.visitorbadge.io/api/VisitorHit?user=toshydev\u0026repo=inspot\u0026countColor=%23BE4BDB)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoshydev%2Finspot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftoshydev%2Finspot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftoshydev%2Finspot/lists"}