Skip to main content
DjangoPythonOpenWeather
Experience weather like never before with a futuristic, real-time, and visually stunning dashboard.

​
📸 Screenshots

Main Screen Detailed View

​
🌟 Features

✅ Live Weather Search — Search any city and get real-time weather updates. 🌡️ Temperature Metrics — Get detailed temperature readings including min/max values. 💨 Wind & Atmospheric Data — Know the wind speed, direction, and air pressure. ☁️ Cloud Coverage Visualization — Interactive visuals for sky conditions. 🌅 Sunrise & Sunset Timings — Plan your day with accurate sun movement data. 📍 Geolocation Support — Fetch weather data based on your real-time location. 🎨 Modern UI & Animations — A sleek, futuristic glassmorphism-inspired design. 📱 Fully Responsive Design — Works seamlessly across devices.

​
🏗️ System Architecture

​
📂 Project Structure

​
🚀 Setup & Installation

​
1️⃣ Clone the Repository

git clone <repository-url>
cd weather_app

​
2️⃣ Install Dependencies

pip install -r requirements.txt

​
3️⃣ Configure Environment Variables

python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate    # On Windows
Create a .env file and add: 
OPENWEATHER_API_KEY=your_api_key_here

​
4️⃣ Apply Migrations & Run Server

python manage.py migrate
python manage.py runserver

​
5️⃣ Open in Browser

http://127.0.0.1:8000/

​
🎨 UI Components

✨ Premium Features:
  • Glassmorphism UI with smooth animations
  • Dynamic weather icons and backgrounds
  • Hover effects and modern transitions
  • Custom scrollbars and interactive cards
🌍 Weather Data Display:
  • Temperature breakdowns (Celsius/Fahrenheit)
  • Wind speed & direction indicators
  • Real-time cloud coverage and rain stats
  • Geolocation-based city detection

​
🔌 API Integration

🔗 OpenWeather API is used for fetching live weather data:
  • Current weather conditions
  • Temperature, wind, and cloud coverage
  • Geographic coordinates & timezone details

​
📱 Responsive Design

🔹 Fully optimized for:
  • Desktop monitors 🖥️
  • Tablets 📱
  • Mobile devices 📲
  • Various screen sizes 🔳

​
🛠️ Technical Stack

  • Backend: Django 5.1.5 (Python 3.12.6)
  • Frontend: HTML5, CSS3, Bootstrap 5
  • API: OpenWeather API
  • Icons: Font Awesome 6
  • Styling: Custom CSS with animations
  • Environment: python-decouple

​
🤝 Contributing

We welcome contributions! 🚀
  1. Fork the repository 🍴
  2. Create your feature branch (git checkout -b feature-name) 🛠️
  3. Commit your changes (git commit -m 'Add some feature') 🔥
  4. Push to the branch (git push origin feature-name) 🚀
  5. Open a Pull Request 💡

​
📜 License

This project is licensed under the MIT License - see the LICENSE file for details.
🌩️ Made with ☀️ and 🌧️ by BrianKN019

​
📧 Contact

For questions or feedback, reach out: 📨 Email: [email protected] 🌐 Portfolio: Brian Kimemia GitHub: BrianKN019
Thank you for exploring this project! Let’s innovate and build secure AWS solutions together. 🚀