Skip to content

1iPluto/WeatherVue

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

☁️ WeatherVue

HTML5 CSS3 JavaScript OpenWeatherMap API
GitHub stars

A modern, responsive weather application built with vanilla JavaScript that provides real-time weather information for any city worldwide.

✨ Features

  • 🌍 Real-time Weather Data - Current conditions for any city worldwide
  • 📱 Responsive Design - Optimized for all devices from mobile to desktop
  • 🌓 Dark/Light Mode - Toggle between themes with system preference detection
  • 📍 Geolocation Support - Automatically detect user's location weather
  • 🕒 Recent Searches - Quick access to previously searched cities
  • ⏰ Local Time Display - Shows the local time of the searched city

📊 Detailed Weather Information

  • Temperature with "feels like" reading
  • Weather description with icons
  • Humidity and wind speed
  • Atmospheric pressure
  • Visibility
  • Sunrise and sunset times

🛠️ Built With

  • HTML5 - Semantic markup structure
  • CSS3 - Modern styling with variables, flexbox, and grid
  • JavaScript - ES6+ features, no frameworks
  • OpenWeatherMap API - Weather data source
  • Local Storage API - Saving preferences and search history
  • Geolocation API - Location detection

🚀 Getting Started

  1. Clone the repository:

    git clone https://github.com/1iPluto/WeatherVue.git
  2. Navigate to the project directory:

    cd WeatherVue
  3. Open js/config.js and replace the API key:

    API_KEY: 'YOUR_OPENWEATHERMAP_API_KEY'
  4. Open index.html in your browser or use a local server

🔑 API Key

This application uses the OpenWeatherMap API:

  1. Sign up at OpenWeatherMap
  2. Generate an API key
  3. Replace the placeholder in js/config.js

📂 Project Structure

WeatherVue/
├── index.html              # Main HTML file
├── css/
│   ├── normalize.css       # CSS reset
│   └── styles.css          # Custom styles
├── js/
│   ├── config.js           # Configuration and API keys
│   ├── utils.js            # Utility functions
│   ├── api.js              # API service
│   ├── ui.js               # UI handling
│   └── app.js              # Main application logic
└── assets/
    └── favicon.png         # Application favicon

🔮 Future Enhancements

  • 5-day weather forecast
  • Weather maps integration
  • Multiple unit system options
  • Weather alerts and notifications
  • Air quality and UV index data

📄 License

MIT License - Feel free to use, modify, and distribute this code.

👤 Author

Marwan Saeed

LinkedIn GitHub

About

Vanilla JS Weather App integrating OpenWeatherMap API to show current weather conditions. Features dynamic UI and error handling

Resources

License

Contributing

Stars

Watchers

Forks

Contributors