Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sugapriya-k/temple-finder
TempleFinder is a web app that helps users discover temples in Tamil Nadu under the Aranilaya Thurai by using geolocation and search features, with map integration via Google Maps API. Built with React for the frontend and Java for the backend.
https://github.com/sugapriya-k/temple-finder
fullstack-development googlemaps-api java locationbasedsearch mapintegration react springboot webapp
Last synced: 2 days ago
JSON representation
TempleFinder is a web app that helps users discover temples in Tamil Nadu under the Aranilaya Thurai by using geolocation and search features, with map integration via Google Maps API. Built with React for the frontend and Java for the backend.
- Host: GitHub
- URL: https://github.com/sugapriya-k/temple-finder
- Owner: sugapriya-k
- Created: 2025-01-04T17:00:01.000Z (23 days ago)
- Default Branch: main
- Last Pushed: 2025-01-04T17:38:44.000Z (23 days ago)
- Last Synced: 2025-01-17T05:11:56.500Z (10 days ago)
- Topics: fullstack-development, googlemaps-api, java, locationbasedsearch, mapintegration, react, springboot, webapp
- Language: JavaScript
- Homepage:
- Size: 278 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌟 TempleFinder 🌟
Welcome to **TempleFinder** – a web application dedicated to helping users discover temples under the **Aranilaya Thurai** of the **Government of Tamil Nadu**. Whether you're exploring sacred places or seeking to connect with cultural heritage, this app shows all temples under the Tamil Nadu Government's Aranilaya Thurai initiative, using your real-time location. 🌍🕌
## Features 🚀
- **🔍 Location-Based Search**: Discover temples under the Aranilaya Thurai based on your current geographical location.
- **🗺️ Interactive Map**: View temple locations visually on a map integrated with Google Maps.
- **📱 Responsive Design**: Enjoy a seamless experience on both desktop and mobile devices.
- **⚡ Fast & User-Friendly**: A simple, intuitive interface for quick and easy navigation.
## 💻 Technologies Used
### **Frontend**:
- **React**: For building the user interface.
- **Material-UI**: For pre-designed UI components.
- **Google Maps API**: For displaying maps and handling geolocation.
- **Axios**: For making API requests.
- **React Router**: For handling navigation and routing.
- **Styled Components**: For writing component-level CSS.
- **React Testing Libraries**: For testing React components.
- **Emotion**: For CSS-in-JS styling.
### **Backend**:
- **Java**: The primary language for the backend.
- **Spring Boot** (likely): Used for building backend APIs.
- **Maven**: For managing project dependencies and builds.
## 🚀 Getting Started
### 1. Clone the Repository
Clone the repository to your local machine:
```bash
git clone https://github.com/sugapriya-k/TempleFinder.git
```
### 2. Install Dependencies
-Navigate into your project folder:
```bash
cd TempleFinder
```
-Then, install the required dependencies:
```bash
npm install
```
### 3. Run the Development Server
-Start the application locally in development mode:
```bash
npm start
```
-Open http://localhost:3000 in your browser to view the app.
The page will automatically reload if you make changes, and you can also see lint errors in the console
### 4. Run Tests (Optional)
To launch the test runner in interactive watch mode:
```bash
npm test
```
### 5. Build for Production
To create an optimized production build:
```bash
npm run build
```
The build is minified, and the filenames include hashes for best performance.
Your app is now ready for deployment.
### 💡 Usage
Once the app is running:
- Your current location will automatically be used to find temples under Aranilaya Thurai.
- You can also search for temples by entering a specific address or city name.
- Explore temples and sacred places in Tamil Nadu, supported by the Government of Tamil Nadu.
### 🤝 Contributing
We love contributions! 🌱 If you want to improve TempleFinder, feel free to:
- Fork this repository
- Submit your pull requests with new features or bug fixes
- Open issues for suggestions or help requests
### 🙏 Acknowledgements
A big thank you to the following for making this project possible:
- Google Maps API for helping us integrate location and maps.
- Open-source community for the amazing tools and resources available.