Mohamed-samy2/Ahlan-Egypt

# Ahlan Egypt - Interactive Travel Companion Ahlan Egypt is a modern, interactive web application designed to enhance travel experiences in Egypt. It helps travelers discover authentic experiences, avoid crowds, and explore hidden gems across Egypt's rich cultural and historical landscape. ## Features - **Interactive Quest System**: Discover and complete unique travel experiences across Egypt - **Crowd Level Tracking**: Real-time information about crowd levels at popular destinations - **Personalized Recommendations**: Get tailored quest recommendations based on interests - **Live Location Tracking**: Navigate to quest locations with built-in maps - **AI Chatbot Assistant**: Get instant help and information about Egyptian culture, history, and travel tips - **Translation Tool**: Translate phrases and signs from English to Arabic and vice versa - **User Profiles**: Track completed quests, earn points, and collect badges ## Technologies Used - React 18 with TypeScript - Tailwind CSS for modern, responsive UI - Firebase Authentication - Context API for state management - Mock API (with future plans for a real backend) ## Getting Started ### Prerequisites - Node.js (v16.0.0 or later) - npm (v8.0.0 or later) ### Installation 1. Clone the repository: ```bash git clone github.com cd ahlan-egypt-app ``` 2. Install dependencies: ```bash npm install ``` 3. Start the development server: ```bash npm start ``` 4. Open your browser and navigate to: ```bash localhost ``` ## Application Structure - `/src/components`: Reusable UI components - `/src/pages`: Main application pages - `/src/contexts`: React Context providers for state management - `/src/api`: API service layer (currently using mock data) - `/src/utils`: Utility functions and helpers - `/src/assets`: Static assets like images and icons ## Available Scripts - `npm start`: Starts the development server - `npm test`: Runs the test suite - `npm run build`: …