https://github.com/willie-conway/travel-recommendation-web-application
🌍 Explore top travel destinations with recommendations for cities, landmarks, temples, and beaches! ✈️🌴🏙️
https://github.com/willie-conway/travel-recommendation-web-application
api css html javascript navigation recommendations travel webapp
Last synced: 3 months ago
JSON representation
🌍 Explore top travel destinations with recommendations for cities, landmarks, temples, and beaches! ✈️🌴🏙️
- Host: GitHub
- URL: https://github.com/willie-conway/travel-recommendation-web-application
- Owner: Willie-Conway
- License: apache-2.0
- Created: 2025-03-19T02:20:53.000Z (7 months ago)
- Default Branch: main
- Last Pushed: 2025-03-20T10:19:33.000Z (7 months ago)
- Last Synced: 2025-06-12T08:44:37.744Z (4 months ago)
- Topics: api, css, html, javascript, navigation, recommendations, travel, webapp
- Language: CSS
- Homepage: https://willie-conway.github.io/Travel-Recommendation-Web-Application/
- Size: 39.7 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🌍 Travel Recommendation Web Application 🌍
Welcome to the **Travel Recommendation Web Application**! ✈️🌎
This web application helps users explore different travel destinations based on their preferences. Whether you're looking for a **beach**, **temple**, or **country** to visit, this platform will suggest the best places for your next adventure.
## 🚀 Features
- **🌐 Navigation Bar**: Easy navigation with links to Home, About Us, and Contact Us.
- **🔍 Search Functionality**: Search destinations by keywords such as "beach", "temple", or "country".
- **🖼️ Visual Appeal**: Beautiful background images and icons for social media links.
- **📅 Clear Results**: Reset search results with the "Clear" button.
- **🕒 Real-Time Data**: Optionally displays the current time of recommended destinations.
## 💻 Technologies Used
- **HTML5**: For building the webpage structure.
- **CSS3**: To style the page and make it responsive.
- **JavaScript**: To handle dynamic functionalities like search and display of recommendations.
- **JSON**: For storing travel recommendation data (places, cities, descriptions, etc.).
## 🌍 Pages
1. **Home Page**: 🏡
- A vibrant landing page with a background image and introduction to the website.
- Search bar for destination-based recommendations.
2. **About Us**: 📖
- Information about the website and the team behind the project.
3. **Contact Us**: 📧
- Contact form to reach out to us for any queries.
## 📂 File Structure
```Travel-Recommendation-Web-Application/
│
├── images/ # Folder for images (e.g., images/sydney.jpg, images/melbourne.jpg)
├── index.html # Home page HTML file
├── LICENSE # About Us page HTML file
├── contact_us.html # License file
├── style.css # Styles for the website
├── travel_recommendation.js # JavaScript file for dynamic functionalities
├── travel_recommendation_api.json # API JSON file with recommendations
```
## 🛠️ How to Run the Application Locally
### 1. Clone or Download the Repository
- **Clone**: `git clone https://github.com/your-username/Travel-Recommendation-Web-Application.git`
- **Download**: Click on the green "Code" button and select "Download ZIP".
### 2. Install a Local Web Server (Optional but Recommended)
To run the app locally, it's better to use a local server. You can use one of the following methods:
#### **Option 1: Using Python HTTP Server**
1. Open your terminal and navigate to your project folder:
```bash
cd path/to/Travel-Recommendation-Web-Application
```
2. Start a Python HTTP server:
- **For Python 3.x**:
```bash
python3 -m http.server 8000
```
- **For Python 2.x**:
```bash
python -m SimpleHTTPServer 8000
```
3. Open your browser and visit `http://localhost:8000/index.html`.
#### **Option 2: Using VS Code with Live Server**
1. Open your project folder in **Visual Studio Code**.
2. Install the **Live Server** extension from the marketplace.
3. Right-click `index.html` and select **"Open with Live Server"**.
4. Your browser should automatically open the page at `http://127.0.0.1:5500/index.html`.
### 3. Enjoy the Application! 🎉
Once the server is running, open your browser and test the app by searching for travel destinations like **beaches**, **temples**, or **countries**. Explore the results, and discover new places for your next vacation!
## 📝 Features in Progress
- 🕒 **Display Local Time**: Show real-time local time of the recommended destination (optional feature).
- 🌎 **Expanded Recommendations**: Additional places to explore (coming soon).
## 📷 Example Images
- **Sydney, Australia**: A vibrant city known for the Sydney Opera House and Harbour Bridge. 🏙️
- **Angkor Wat, Cambodia**: The largest religious monument in the world, a UNESCO World Heritage site. 🏯
- **Bora Bora, French Polynesia**: Known for its turquoise waters and overwater bungalows. 🏖️
## 🤝 Contributing
We welcome contributions! If you'd like to improve this project or suggest a new feature, feel free to fork this repository and submit a pull request.
## 👀 License
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
Happy Travels! 🌍✈️ Let the adventure begin! 🌟