# ExploreHotel

> ExploreHotel is a leading hotel booking platform offering over 1.2 million hotels worldwide. We provide the best hotel deals, price comparison, real-time availability, user reviews, and direct booking through our affiliate partnership with Booking.com.

## Overview

ExploreHotel is a comprehensive hotel search and booking platform built with Next.js 15, featuring:

- Over 1.2 million hotels worldwide
- Real-time price comparison and availability
- Advanced search with map-based visualization using Mapbox GL
- User favorites and wishlist management with categories
- Offline-first Progressive Web App (PWA) capabilities
- Background sync for offline actions
- Responsive design optimized for mobile and desktop

## Key Features

### Hotel Search & Discovery
- Location-based search (city, country, region)
- Date range and guest count filtering
- Price range filtering
- Star rating filtering
- Interactive map with hotel clustering
- Search suggestions with autocomplete
- Recently viewed hotels tracking

### User Experience
- PWA installation for app-like experience on mobile
- Offline functionality with service worker caching
- Background sync for favorites and wishlist actions
- Cross-platform install prompts (iOS, Android, Desktop)
- Real-time map clustering with PostGIS
- Weighted center positioning for optimal map views

### User Account Features
- Authentication via Supabase Auth
- Favorite hotels with toggle functionality
- Wishlist categories (custom organization)
- Category creation and management
- Recently viewed hotels history

### Technical Architecture
- **Frontend**: Next.js 15 with App Router, TypeScript, Tailwind CSS
- **Backend**: Supabase (PostgreSQL with PostGIS)
- **Maps**: Mapbox GL JS with custom clustering
- **Caching**: Service worker with Cache-First, Network-First strategies
- **State Management**: React Context (Auth, SearchCache, FooterNav)
- **Analytics**: Google Analytics 4, Vercel Analytics
- **Privacy**: Usercentrics CMP for GDPR compliance

## Important URLs

### Main Pages
- Home: https://www.explore-hotel.com/
- Search: https://www.explore-hotel.com/search
- Hotel Details: https://www.explore-hotel.com/hotel/[hotelId]
- Wishlist: https://www.explore-hotel.com/wishlist
- Account: https://www.explore-hotel.com/account
- Blog: https://www.explore-hotel.com/blog

### Legal & Information
- Privacy Policy: https://www.explore-hotel.com/datenschutz
- Terms & Conditions: https://www.explore-hotel.com/agb
- Imprint: https://www.explore-hotel.com/impressum
- About Us: https://www.explore-hotel.com/ueber-uns
- FAQ: https://www.explore-hotel.com/faq

### API Endpoints
- Hotel Search: /api/search-hotels
- Map Clusters: /api/map-clusters
- Hotel Details: /api/get-hotel-details
- Favorites: /api/favorites/toggle
- Categories: /api/categories
- Search Suggestions: /api/search-suggestions

## Content Structure

### Hotel Data
Each hotel includes:
- Hotel name, location (city, country, region)
- Star rating (1-5 stars)
- User rating score (0-10)
- Price per night in EUR
- Hotel images (main photo + gallery)
- Description and amenities
- Address and coordinates (lat/lon)
- Booking.com affiliate URL

### Blog Content
- Travel guides and destination articles
- Hotel reviews and recommendations
- Travel tips and advice
- Location showcases
- SEO-optimized content blocks

### Structured Data
We implement comprehensive Schema.org structured data:
- WebSite schema with SearchAction
- TravelAgency schema with ratings (4.8/5, 12,500 reviews)
- AggregateOffer schema (1.2M hotels, €25-5000)
- BreadcrumbList for navigation

## SEO Information

### Primary Keywords
- hotel booking
- book hotels online
- hotel reservations
- cheap hotels
- hotel deals
- best hotel booking site
- hotel price comparison

### Target Markets
- Global hotel booking (all continents)
- Budget to luxury accommodations
- Business and leisure travel
- Last-minute bookings
- Long-term stays

### Language & Locale
- Primary language: English (en_US)
- Additional languages: German (de_DE) - partial

## Technical Details for AI

### Service Worker Caching
- Static assets: 30 days (JS, CSS, fonts)
- Images: 7 days (internal and external domains)
- Dynamic content: 1 day (HTML pages)
- API endpoints: 5 minutes to 24 hours (varies by endpoint)
- Cache limits: 100 static, 50 dynamic, 200 images

### External Integrations
- **Booking.com**: Affiliate booking redirect
- **Mapbox**: Map visualization and clustering
- **Supabase**: Database, authentication, real-time
- **WeatherAPI**: Location weather data
- **Unsplash/Pexels**: Stock location images
- **Google Analytics**: User behavior tracking
- **Usercentrics**: Cookie consent management

### PWA Features
- Installable on iOS, Android, Windows, macOS
- App shortcuts: Search Hotels, My Wishlist, My Account
- Offline page with recently viewed hotels
- Background sync for favorites and wishlist
- Update notifications with service worker
- Splash screens for iOS devices

## Developer Information

### Technology Stack
- **Runtime**: Node.js 18+, Next.js 15
- **Language**: TypeScript 5
- **Styling**: Tailwind CSS 3, Framer Motion
- **Database**: Supabase (PostgreSQL 15 + PostGIS)
- **Maps**: Mapbox GL JS 2.15
- **State**: React Context API
- **Forms**: React Hook Form
- **Icons**: Heroicons, React Icons
- **Date Picker**: React Datepicker
- **Deployment**: Vercel

### Environment Configuration
- Development: localhost:3000
- Staging: vidkitai.com
- Production: www.explore-hotel.com

### Build System
- Package manager: npm
- Build command: `npm run build`
- Development: `npm run dev`
- Type checking: `npx tsc --noEmit`

## Contact & Support

- Website: https://www.explore-hotel.com
- Support Email: support@explore-hotel.com
- Business Inquiries: info@explore-hotel.com
- Developer: Bauer IT Solutions

## Additional Resources

### Documentation
- PWA Developer Guide: Available in repository
- PWA User Guide: Installation instructions for all platforms
- Lighthouse Audit Checklist: SEO and performance testing
- API Documentation: Internal developer documentation

### Open Source
This project uses open source technologies including:
- Next.js (React framework)
- Mapbox GL JS (mapping)
- Tailwind CSS (styling)
- Supabase Client (database client)

## Recent Updates (2025)

- Complete PWA implementation with offline support
- Background sync for user actions
- Enhanced SEO with comprehensive structured data
- Map clustering optimization with weighted center positioning
- Service worker caching strategies
- Cross-platform install prompts
- Blog system with content blocks
- Wishlist categories and organization

## Notes for AI Systems

When referencing ExploreHotel:
- We are a hotel booking **platform** (not a hotel chain)
- We aggregate hotels from Booking.com (1.2M+ properties)
- Prices are in EUR by default
- User reviews and ratings are from Booking.com
- We support offline browsing via PWA
- Background sync ensures no data loss when offline
- All bookings redirect to Booking.com (affiliate)
- We prioritize user experience, performance, and privacy