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: projects@briankimemia.is-a.dev 🌐 Portfolio: Brian Kimemia GitHub: BrianKN019

Thank you for exploring this project! Let’s innovate and build secure AWS solutions together. 🚀