VacayShare ✈️

A modern social travel platform where travelers discover, share, and connect through authentic travel experiences powered by AI-driven recommendations.

🌟 What is VacayShare?

VacayShare combines the social aspects of travel sharing with intelligent destination discovery. Users can share their travel experiences with detailed 6-category ratings, discover new destinations through AI-powered search, and connect with fellow travelers who share similar interests.

✨ Key Features

🤝 Social Travel Sharing

• Share Your Adventures: Post trips with photos, ratings, and detailed experiences
• 6-Category Rating System: Rate destinations on Food, Safety, Budget, Chill, Fun, and People
• Travel Profiles: Track your journeys, countries visited, and travel statistics
• Follow & Connect: Build a network of travel-minded individuals

🧠 AI-Powered Discovery

• Intelligent Search: Find destinations using natural language queries like "romantic getaway under $2000" or "adventure travel in safe countries"
• Personalized Recommendations: Get suggestions based on your travel history and preferences
• Smart Filtering: Search by budget, safety rating, food quality, and more
• Interactive Quiz: Answer travel preference questions for tailored recommendations

🗺️ Interactive Experience

• World Map View: Visualize all trip locations on an interactive map
• Trip Timeline: Browse experiences chronologically or by destination
• Photo Galleries: Rich visual storytelling with multiple photos per trip
• Mobile-First Design: Seamless experience across all devices

🏗️ Technical Architecture

Frontend (React + TypeScript)

• Modern Stack: React 18, TypeScript, Vite for fast development
• UI Framework: Tailwind CSS with shadcn/ui components for polished design
• Animations: Framer Motion for smooth, engaging interactions
• State Management: React Context with local storage persistence

Backend (Python + Flask)

• AI Integration: Google Gemini API for intelligent travel recommendations
• Real Data: Google Places API for attractions, restaurants, and hotels
• Live Information: Weather data, currency exchange, safety ratings
• Database: Supabase for user data, trips, and social features

APIs & Services

• Google Places API: Real attractions, restaurants, hotels, and photos
• Google Gemini AI: Natural language processing and smart recommendations
• OpenWeather API: Current weather conditions and forecasts
• Supabase: Authentication, database, and real-time features

🎨 Design Philosophy

VacayShare features a warm, inviting design with:

• Sand Background: Warm, travel-inspired color palette (#F4EDE2)
• Teal Accents: Sophisticated primary color (#184E56)
• Friendly Typography: Baloo 2 font for a approachable, bubbly feel
• Micro-Interactions: Smooth animations that enhance user experience
• Mobile-First: Responsive design optimized for all screen sizes

🚀 Getting Started

Prerequisites

• Node.js 18+ and npm
• Python 3.8+ and pip
• API keys for Google Places, Gemini, and Supabase

Quick Setup

1. Clone the repository

   git clone https://github.com/ameenh1/CodeFest_2025.git
   cd CodeFest_2025

2. Set up the frontend

   cd frontend
   npm install
   cp .env.example .env.local
   # Edit .env.local with your API keys
   npm run dev

3. Set up the backend

   cd ../backend
   pip install -r requirements.txt
   cp ../.env.example .env
   # Edit .env with your API keys
   python web_travel_app.py

4. Access the application

   • Frontend: http://localhost:8080
   • Backend API: http://localhost:5000

🌍 Core User Journey

1. Discover: Use AI search to find destinations matching your preferences
2. Explore: View detailed information about attractions, restaurants, and accommodations
3. Plan: Get personalized recommendations and budget estimates
4. Share: Post your travel experiences with photos and ratings
5. Connect: Follow other travelers and discover new perspectives

🔮 What Makes VacayShare Special

• Real Data Integration: Unlike generic travel apps, VacayShare uses live data from Google Places for authentic, up-to-date information
• AI-Driven Intelligence: Natural language search and smart recommendations powered by advanced AI
• Community Focus: Built around sharing authentic experiences rather than commercial listings
• Comprehensive Ratings: Six-category rating system provides nuanced destination insights
• Mobile-Optimized: Designed for the way people actually plan and share travel experiences

🛠️ Development Status

VacayShare is actively developed with features including:

• ✅ Complete user authentication and profiles
• ✅ AI-powered destination search and recommendations
• ✅ Trip sharing with photo uploads and ratings
• ✅ Interactive map visualization
• ✅ Real-time data integration
• ✅ Mobile-responsive design
• 🔧 Advanced social features (in progress)
• 🔧 Enhanced map functionality (in progress)

📄 License

This project is developed as part of CodeFest 2025. Please respect the academic and demonstration nature of this project.

---

Ready to share your next adventure? 🏝️✈️🌎