GuideGuru - Your Ultimate Tourist Guide Web App
Welcome to GuideGuru, a full-featured and responsive web application designed to enhance the travel experience for tourists. Developed using the MERN stack (MongoDB, Express.js, React.js, Node.js), GuideGuru provides a comprehensive platform for tourists to explore destinations, plan their trips, and stay informed with real-time updates. Leveraging JWT authentication, Weather API, 360 View API, and other cutting-edge technologies, GuideGuru ensures a secure, immersive, and user-friendly experience.
Key Features:
- User Authentication: Secure user accounts with JWT authentication for safe and personalized access to the app.
- Weather Updates: Get real-time weather information for your destinations using the integrated Weather API, ensuring you’re always prepared.
- 360° Views: Explore destinations in an immersive way with 360° panoramic views, offering a virtual tour experience.
- Destination Search and Recommendations: Discover popular tourist spots, attractions, and hidden gems with an intelligent search and recommendation system.
- Itinerary Planner: Plan your trips efficiently with a built-in itinerary planner that helps you organize your travel schedule.
- Responsive Design: Enjoy a seamless experience across all devices with a fully responsive design that adapts to desktops, tablets, and smartphones.
- Interactive Map: Utilize the interactive map feature to navigate and find points of interest easily.
- Reviews and Ratings: Read reviews and ratings from other travelers to make informed decisions about places to visit.
- Advanced Technologies: Developed using the latest web technologies including MERN stack, JWT authentication, and integrated APIs for a robust and scalable application.
How to Use:
- Clone the repository to access the source code.
- Install the necessary dependencies using
npm install
for both the client and server. - Configure environment variables for API keys and JWT secret in a
.env
file. - Run the development servers for both client and server using
npm run dev
. - Access the application through your browser and explore the features of GuideGuru.
Installation:
- Clone the repository:
git clone https://github.com/yourusername/guideguru.git
- Navigate to the project directory:
cd guideguru
- Install server dependencies:
cd server npm install
- Install client dependencies:
cd client npm install
- Set up environment variables in a
.env
file in the server directory:PORT=5000 MONGO_URI=your_mongodb_uri JWT_SECRET=your_jwt_secret WEATHER_API_KEY=your_weather_api_key VIEW360_API_KEY=your_360view_api_key
- Start the development server:
npm run dev
MEMBERS
- Vihan Jayasinghe.
- Sahan kalhara.
- Kavindu Lakshan perera.
- Harindu chamod Munasinghe.
Embark on a seamless and enriching travel experience with GuideGuru. Explore, plan, and enjoy your journeys with confidence and convenience. We welcome your feedback and contributions to make GuideGuru even better. ❤😊🎉