> ## Documentation Index
> Fetch the complete documentation index at: https://docs.briankimemia.is-a.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 🌦️ Premium Weather Dashboard

> A sophisticated weather application providing real-time weather data with a premium UI and seamless experience.

![Django](https://img.shields.io/badge/Django-5.1.5-green.svg)![Python](https://img.shields.io/badge/Python-3.12.6-blue.svg)![OpenWeather](https://img.shields.io/badge/OpenWeather-API-orange.svg)

> **Experience weather like never before with a futuristic, real-time, and visually stunning dashboard.**

## 📸 Screenshots

<img src="https://mintlify.s3.us-west-1.amazonaws.com/br/Public/images/sc1.PNG" alt="Main Screen" />

<img src="https://mintlify.s3.us-west-1.amazonaws.com/br/Public/images/sc2.PNG" alt="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

```mermaid theme={null}
graph TD
A[Client Browser] -->|HTTP Request| B[Django Server]
B -->|URL Routing| C[Weather Views]
C -->|API Request| D[OpenWeather API]
D -->|Weather Data| C
C -->|Context Data| E[Templates]
E -->|Rendered HTML| A
F[Static Files] -->|CSS/JS| A
```

## 📂 Project Structure

```mermaid theme={null}
graph LR
A[weather_app] -->|Project Root| B[weather]
A -->|Settings| C[weather_app/settings.py]
A -->|URLs| D[weather_app/urls.py]
B -->|Views| E[weather/views.py]
B -->|Templates| F[weather/templates]
B -->|Static| G[weather/static]
B -->|URLs| H[weather/urls.py]
```

## 🚀 Setup & Installation

### 1️⃣ Clone the Repository

```bash theme={null}
git clone <repository-url>
cd weather_app
```

### 2️⃣ Install Dependencies

```bash theme={null}
pip install -r requirements.txt
```

### 3️⃣ Configure Environment Variables

```bash theme={null}
python -m venv venv
source venv/bin/activate  # On macOS/Linux
venv\Scripts\activate    # On Windows
```

Create a `.env` file and add:

```env theme={null}
OPENWEATHER_API_KEY=your_api_key_here
```

### 4️⃣ Apply Migrations & Run Server

```bash theme={null}
python manage.py migrate
python manage.py runserver
```

### 5️⃣ Open in Browser

```bash theme={null}
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](https://github.com/BrianKN019)

## 📧 Contact

For questions or feedback, reach out:

📨 Email: [projects@briankimemia.is-a.dev](mailto:projects@briankimemia.is-a.dev)
🌐 Portfolio: [Brian Kimemia](https://briankimemia.is-a.dev/)
**GitHub:** [BrianKN019](https://github.com/BrianKN019)

***

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