Eureka

Eureka is a website where you can find local spots near you which don't show up on Google Maps or any other apps

Eureka is a project made by a person who loves street food for the people who love underrated stuff which is not on the traditional internet. No algorithms, just people helping other people find the best spot near them.

---

Demo Video

Google Drive Link for the Demo Video LINK

Or you could actually try it VISIT THE WEBSITE now!

About

Every city has that amazing local shop where people enjoy everyday but its not on google maps maybe the shop owners are not aware or just not interested in adding it there. But we as people who love the food they make or the overall vibe must come forward to share the spots to other people, maybe visitors etc. (DONT GATEKEEP IT LET EVERYONE EXPERIENCE THE JOY OF GREAT FOOOOOD)

I built Eureka for Foodie YSWS a map where people can mark their underrated spots

---

Features

• Interactive Map: Users can browse locations on an interactive map interface
• Add Locations: They can mark their favorite hidden gems on the map with details
• Rate & Review: Users can even add ratings and write about what makes each place special
• Edit Reviews: Other users can use the public edit feature to fix any mistakes
• Location Details: All details is at one place so everything is streamlined
• Search & Discover: Users can search based on categories or locations

---

Tech Stack

Built with:

• Flask - Python web framework
• Leaflet.js - Interactive maps
• JSON - Data storage (for now we can use SQLite to scale it later with a SQL Database)
• HTML/CSS/JavaScript - Frontend

---

Project Structure

Eureka/
├── assets/           # Project assets and media
├── data/             # JSON data storage for locations and ratings
├── static/           # CSS, JavaScript, and static files
├── templates/        # HTML templates
├── app.py            # Main Flask application
├── requirements.txt  # Python dependencies
├── .gitignore        # Git ignore file
├── LICENSE           # MIT License
└── README.md         # You're reading this lol

---

Setup and Installation

Prerequisites

• Python 3.13+ (tested on 3.13.5)
• pip for package management

Installation Steps

1. Clone the repository:

   git clone https://github.com/Rexaintreal/Eureka.git
   cd Eureka

2. Create a virtual environment (recommended if you like to keep everything CLEAN):

   Windows:

   python -m venv venv
   .\venv\Scripts\activate

   macOS / Linux:

   python3 -m venv venv
   source venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Run the application:

   python app.py

5. Open in browser:

   Navigate to http://127.0.0.1:5000

---

Usage

1. Browse the map to see existing locations marked by the community
2. Click on markers to see ratings and reviews for each spot
3. Add a new location by clicking on the map and filling in details
4. Rate places you've been to and share what makes them special
5. Edit your reviews anytime to update your thoughts
6. Discover hidden gems in your area that you never knew existed

---

How It Works

• Locations are stored in JSON format in the data/ directory
• Each location can have multiple ratings and reviews from different users
• The map uses Leaflet.js for interactive mapping (FREE API TYSM)
• All data is currently stored locally (database integration can be implemented)
• Community-driven content means no ads or sponsored listings (needs filtering and moderation tho)

---

Contributing

FEEL FREE TO ADD OR REMOVE THINGS I'd love to see people work on this lol (no one does)

---

License

MIT LICENSE

---

Acknowledgements

Built for Foodie YSWS at Hack Club.

---

You may also like...

Check out my other projects:

• DawnDuck - USB HID Automation Tool for Morning Routines
• Lynx - OpenCV Image Manipulation WebApp
• Libro Voice - PDF to Audio Converter
• Snippet Vision - YouTube Video Summarizer
• Weather App - Python Weather Forecast App
• Python Screenrecorder - Python Screen Recorder
• Typing Speed Tester - Python Typing Speed Tester
• Movie Recommender - Python Movie Recommender
• Password Generator - Python Password Generator
• Object Tales - Python Image to Story Generator
• Finance Manager - Flask WebApp to Monitor Savings
• Codegram - Social Media for Coders
• Simple Flask Notes - Flask Notes App
• Key5 - Python Keylogger
• Codegram2024 - Modern Codegram Update
• Cupid - Dating Web App for Teenagers
• Gym Vogue - Ecommerce for Gym Freaks
• Confessions - Anonymous Confession Platform
• Syna - Social Music App with Spotify
• Apollo - Minimal Music Player with Dancing Cat
• Eros - Face Symmetry Analyzer
• Notez - Clean Android Notes App

---

Author

Built by Saurabh Tiwari

• Email: saurabhtiwari7986@gmail.com
• Twitter: @Saurabhcodes01
• Instagram: @saurabhcodesawfully