Skip to content

About

Vanilla JavaScript weather app with clean architecture, accessibility-first design, and responsive UI.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

35 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Weather App 🌦️

A modern, responsive Weather Application built with HTML, CSS, and JavaScript. The app provides real-time weather data with a clean UI and smooth user experience across all devices .

Version

Current release: v1.0.0

Live Demo 🚀

👉 https://weather-app-virid-six-92.vercel.app/

Features ✨

  • 🌍 Real-time weather data .
  • 📱 Fully responsive design (Mobile / Tablet / Desktop) .
  • 🎨 Clean and modern UI .
  • ⚡ Fast loading performance .
  • 🔎 Search for any city worldwide .
  • 🌙 Dynamic weather conditions (icons + background updates) .

Accessibility ♿

  • Semantic HTML structure
  • Keyboard accessible dropdowns
  • ARIA attributes
  • Focus management
  • Screen reader support
  • Accessible search suggestions

Smart Default Location (Important Feature) 🌐

One of the key features of this project is intelligent initial city detection based on the user's device language.

When the app is opened for the first time (before user interaction or confirmation screen appears):

  • If device language is Arabic → default city is Cairo .
  • If device language is English → default city is London .
  • Other languages → fallback default city (e.g., New York or a global default) .

Why this matters: 💡

This improves user experience (UX) by:

  • Reducing empty states on first load .
  • Showing relevant data immediately .
  • Making the app feel “localized” and intelligent .

Technologies Used 🧠

  • HTML5.
  • CSS3 (Flexbox / Grid) .
  • JavaScript (ES6+) .
  • Weather API integration .

Responsive Design 📱

The UI is designed with a mobile-first approach, ensuring:

  • Smooth layout on small screens .
  • Optimized spacing and typography .
  • Adaptive components for all devices .

Project Structure ⚙️

  • root/
  • │
  • ├── assets/
  • │ └── data
  • │ └── Cities.json
  • │ └── fonts
  • │ └── images
  • │ └── screenshots
  • │
  • ├── public/
  • │
  • ├── src/
  • │ │
  • │ ├── data/
  • │ │ └── API.js
  • │ │ └── Cities.js
  • │ │
  • │ ├── app/
  • │ │ └── APP.js
  • │ │
  • │ ├── config/
  • │ │ └── langugeCityMap.js
  • │ │
  • │ ├── logic/
  • │ │ └── Logic.js
  • │ │
  • │ ├── ui/
  • │ │ └── UI.js
  • │ │ └── UIController.js
  • │ │
  • │ ├── tools/
  • │ │ └── Cache.js
  • │ │ └── Validator.js
  • │ │
  • │ ├── styles/
  • │ │ ├── base.css
  • │ │ ├── layout.css
  • │ │ ├── components.css/
  • │ │ ├── utilities.css
  • │ │ └── state.css
  • │ │
  • │ │
  • │ └── main.js
  • │
  • ├── index.html
  • └── README.md

Screenshots 📸

Desktop View

👉 Desktop Preview

Mobile View

Mobile Preview

What I Learned 🎯

  • Working with APIs and asynchronous JavaScript.
  • Handling UI states (loading / success / error).
  • Improving UX with smart defaults.
  • Responsive design principles.
  • Clean project structure.

Future Improvements 🚀

  • Add hourly forecast charts.
  • Save favorite cities.
  • More specified Suggestions and show the adminstartive for same cities .
  • authentication .
  • Geolocation auto-detection.
  • PWA support (installable app).

Author 👨‍💻

Built by a Frontend Developer focused on:

  • Clean UI/UX.
  • Responsive design.
  • Real-world project architecture.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

About

Vanilla JavaScript weather app with clean architecture, accessibility-first design, and responsive UI.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages