A comprehensive AI-powered travel planning Progressive Web App (PWA) that helps you plan trips, find hotels, track budgets, check weather, and connect with other travelers.

The backend uses a feature-aware multi-model routing system with automatic fallback:

• Rate Limit Prediction: Skips models near RPM limit before failure
• Semantic Caching: 24-hour cache for trip itineraries and hotel searches
• Graceful Degradation: Never exposes LLM errors to users
• Observability: Full logging of model selection, latency, and fallbacks

The AI generates:

• Day-by-day itineraries with morning, afternoon, and evening activities
• Hotel recommendations based on destination, budget, and preferences
• Estimated costs for activities and accommodations
• Travel tips customized for each destination

┌─────────────────────────────────────────────────────────────┐
│                     Frontend (React + Vite)                  │
│   ┌─────────────┬────────────┬─────────────┬─────────────┐  │
│   │ Trip Planner│Hotel Search│   Weather   │  Community  │  │
│   └──────┬──────┴─────┬──────┴──────┬──────┴──────┬──────┘  │
│          │            │             │             │          │
│          └────────────┴──────┬──────┴─────────────┘          │
│                              │                               │
│                    ┌─────────▼─────────┐                     │
│                    │ Backend API Proxy │                     │
│                    │    (FastAPI)      │                     │
│                    └─────────┬─────────┘                     │
└──────────────────────────────┼───────────────────────────────┘
                               │
          ┌────────────────────┼────────────────────┐
          ▼                    ▼                    ▼
   ┌──────────────┐    ┌──────────────┐    ┌──────────────┐
   │  Groq API    │    │ OpenWeather  │    │   Mapbox     │
   │ (LLM Model)  │    │     API      │    │  Geocoding   │
   └──────────────┘    └──────────────┘    └──────────────┘

All sensitive API calls are routed through a FastAPI backend proxy with intelligent model routing:

• Hero section with Lottie animation
• Destination search to start trip planning
• Quick access to all features

• Enter destination, dates, budget, and preferences
• AI generates complete day-by-day itinerary
• Save trips to your account
• Start budget tracking from planned trip

AI Model: Groq llama-3.3-70b-versatile

• Search hotels by destination
• Filter by budget category (Budget/Mid-range/Luxury)
• AI-powered hotel recommendations with ratings
• Shortlist favorite hotels

AI Model: Groq llama-3.3-70b-versatile

• Search weather by city name
• Auto-detect weather from user location
• Temperature, humidity, wind speed
• Weather icons and conditions

API: OpenWeatherMap

• View all saved trip itineraries
• Edit day activities
• Delete trips
• Navigate to budget tracker

• Set total trip budget
• Track expenses by category:
  • 🏨 Accommodation
  • 🍽️ Food & Dining
  • 🚗 Transport
  • 🎯 Activities
  • 🛍️ Shopping
  • 📦 Other
• Visual spending breakdown
• Multi-currency support (USD, EUR, INR, etc.)

• Share travel experiences
• Create polls
• Like and comment on posts
• View other travelers' profiles

• Customizable profile with photo
• Travel style selection
• Favorite destination
• Countries visited counter

• Create travel checklists
• Cloud-synced across devices
• Mark items complete

• View all bookmarked hotels
• Quick access to favorites
• Remove from shortlist

Supported login methods:

• Google Sign-In (OAuth 2.0)
• Apple Sign-In (OAuth 2.0)
• Email/Password with verification

All authentication is handled via Firebase Auth.

• React 18 - UI framework
• Vite - Build tool & dev server
• Tailwind CSS - Styling
• Material Tailwind - UI components
• React Router - Navigation
• Axios - HTTP client
• Lottie - Animations
• Mapbox GL - Maps integration

• FastAPI - Python API framework
• httpx - Async HTTP client
• python-dotenv - Environment variables
• Pydantic - Data validation

• Firebase - Auth, Firestore, Storage
• Groq - LLM inference
• OpenWeatherMap - Weather data
• Mapbox - Geocoding & maps

Desktop-UI	Phone-UI

• Node.js 18+
• Python 3.9+
• Firebase project

1. Clone the repository

   git clone https://github.com/SayantaniDeb/Travellwithus.git
   cd Travellwithus

2. Install frontend dependencies

   npm install

3. Install backend dependencies

   cd backend
   pip install -r requirements.txt
   cd ..

4. Configure environment variables

   Create .env in the root directory:

   VITE_FIREBASE_API=AIzaSy...your-firebase-api-key

   Create backend/.env:

   GROQ_API_KEY=gsk_...your-groq-key
   OPENWEATHER_API_KEY=your-openweather-key
   MAPBOX_ACCESS_TOKEN=pk....your-mapbox-token

5. Start the backend server

   cd backend
   uvicorn main:app --reload --port 8000

6. Start the frontend dev server

   npm run dev

7. Open in browser

   http://localhost:5173
   

Travellwithus/
├── backend/
│   ├── main.py              # FastAPI server with smart routing
│   ├── requirements.txt     # Python dependencies
│   ├── .env                 # Backend secrets (not in git)
│   └── ai_router/           # Multi-model routing system
│       ├── router.py        # Main routing logic
│       ├── classifier.py    # Feature classification
│       ├── matrix.py        # Model fallback chains
│       ├── cache.py         # Semantic caching
│       ├── rate_limiter.py  # RPM tracking & prediction
│       ├── features.py      # Feature type definitions
│       └── providers/       # LLM provider implementations
│           ├── groq_provider.py
│           └── local_provider.py
├── public/
│   ├── icons/               # Weather & app icons
│   ├── sw.js                # Service worker for PWA
│   └── site.webmanifest     # PWA manifest
├── src/
│   ├── components/
│   │   ├── TripPlanner.jsx  # AI trip generation
│   │   ├── HotelSearch.jsx  # AI hotel recommendations
│   │   ├── Weather.jsx      # Weather lookup
│   │   ├── BudgetTracker.jsx# Expense tracking
│   │   ├── Community.jsx    # Social features
│   │   ├── Profile.jsx      # User profiles
│   │   ├── SavedTrips.jsx   # Trip management
│   │   ├── Shortlist.jsx    # Hotel bookmarks
│   │   ├── Todolist.jsx     # Travel checklist
│   │   └── ...
│   ├── context/
│   │   └── LocationContext.jsx # Location state management
│   ├── Firebase.jsx         # Firebase configuration
│   ├── RouterPath.jsx       # App routes
│   ├── App.jsx              # Root component
│   └── main.jsx             # Entry point
├── .env                     # Frontend env vars (VITE_*)
├── package.json
├── vite.config.js           # Vite config with proxy
└── tailwind.config.js

TravelWithUs is a Progressive Web App:

• ✅ Installable on iOS, Android, and desktop
• ✅ Offline-capable via service worker
• ✅ Responsive design for all screen sizes
• ✅ Push notifications ready
• ✅ App-like experience with no browser UI

• Groq for blazing fast LLM inference
• Firebase for backend services
• OpenWeatherMap for weather data
• Mapbox for geocoding services
• LottieFiles for animations
• Tailwind CSS - Utility-first CSS framework
• Material Tailwind - Material Design components
• React - UI library by Meta
• Unicons - Scalable vector icons

Built with ❤️ by TravelWithUs Team