Skip to content

MsParadox/Weather-Forecasting-App

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🌤️ Weather Forecasting App

Real-time weather data for any city, anywhere in the world.

Live Demo GitHub Repo MIT License JavaScript OpenWeather API


🧩 Project Overview

Weather Forecasting App is a responsive web application that displays real-time weather data for any location worldwide using the OpenWeatherMap API. Users can search for any city and instantly view current conditions and a 5-day forecast — with seamless °C / °F unit conversion at a click.

  • 🌡️ Live temperature readings with min/max range
  • 💨 Wind speed, cloud cover, rain probability & humidity
  • 📅 5-day extended forecast for better trip planning
  • 🔄 Instant Celsius ↔ Fahrenheit toggle

🖼️ Screenshots

Landing Page

Landing Page

Current Weather

Current Weather

5-Day Forecast

5-Day Forecast


✨ Features

Feature Details
🔍 City Search Search real-time weather for any city worldwide
🌡️ Temperature Current, min & max temperature display
💧 Humidity Live humidity percentage
💨 Wind Speed Current wind speed readings
☁️ Cloud Cover Cloud percentage and rain possibility
🔄 Unit Toggle Switch between Celsius and Fahrenheit instantly
📅 5-Day Forecast Extended forecast for better planning
📱 Responsive Design Works seamlessly across all devices

🛠️ Tech Stack

Technology Purpose
HTML5 Markup & structure
CSS3 Styling & responsive layout
JavaScript (ES6+) Core logic & API integration
Bootstrap UI components & responsiveness
NPM Package management
Webpack Module bundling
OpenWeatherMap API Real-time weather data
GitHub Actions CI/CD pipeline

🚀 Getting Started

Option 1 — Use the Live App

👉 Visit weather-forecasting-app-pied.vercel.app and start searching!


Option 2 — Run Locally

Prerequisites

  • A modern, up-to-date browser 💪
  • Node.js & npm installed
  • A free OpenWeatherMap API keyGet one here

Installation

# 1. Clone the repository
git clone https://github.com/MsParadox/Weather-Forecasting-App.git

# 2. Navigate into the project folder
cd Weather-Forecasting-App

# 3. Install dependencies
npm install

# 4. Add your API key
#    Create a .env file or update the config file with your OpenWeatherMap API key
echo "API_KEY=your_openweathermap_api_key_here" > .env

# 5. Build and start the app
npm start

Then open http://localhost:8080 in your browser. 🎉


🔮 Future Features

  • Hourly forecast breakdown
  • Geolocation-based auto-detection
  • Weather alerts and notifications
  • Dark / Light theme toggle
  • Favourite cities list
  • Interactive weather maps

👨‍💻 Author

Mohit Sharma

Full Stack Developer · Problem Solver · Open Source Enthusiast

LinkedIn GitHub Codeforces LeetCode Email


🤝 Contributing

Contributions, issues, and feature requests are always welcome!

  1. Fork the repository
  2. Create your feature branch: git checkout -b feature/amazing-feature
  3. Commit your changes: git commit -m 'Add some amazing feature'
  4. Push to the branch: git push origin feature/amazing-feature
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License.


Found this project useful? Drop a star — it means a lot!

About

A weather app that pulls from the OpenWeatherMap API to allow users to search for and view the forecast in cities worldwide. Built with JavaScript.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors