Skip to content

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.

Notifications You must be signed in to change notification settings

sugapriya-k/Temple-Finder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌟 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.
  • Google Maps API: For displaying maps and handling geolocation.
  • React Router: For handling navigation and routing.
  • React Testing Libraries: For testing React components.

Backend:

  • Java: The primary language for the backend.
  • Spring Boot : Used for building backend APIs.

🚀 Getting Started

1. Clone the Repository

Clone the repository to your local machine:

git clone https://github.com/sugapriya-k/TempleFinder.git

2. Install Dependencies

-Navigate into your project folder:

cd TempleFinder

-Then, install the required dependencies:

npm install

3. Run the Development Server

-Start the application locally in development mode:

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:

npm test

5. Build for Production

To create an optimized production build:

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.

About

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.

Topics

Resources

Stars

Watchers

Forks