Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/himel-sarder/climavibe-weatherapp-django
ClimaVibe is a Django-based weather application that provides real-time weather information for predefined cities as well as any city entered by the user. The app uses the OpenWeather API to fetch weather data such as temperature, weather description, and corresponding weather icons.
https://github.com/himel-sarder/climavibe-weatherapp-django
django django-application django-project django-rest-framework python python-django-bootstrap python3 tailwind tailwindcss weather-api weather-app
Last synced: 4 days ago
JSON representation
ClimaVibe is a Django-based weather application that provides real-time weather information for predefined cities as well as any city entered by the user. The app uses the OpenWeather API to fetch weather data such as temperature, weather description, and corresponding weather icons.
- Host: GitHub
- URL: https://github.com/himel-sarder/climavibe-weatherapp-django
- Owner: Himel-Sarder
- License: mit
- Created: 2024-08-25T13:46:43.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2024-08-26T06:40:37.000Z (2 months ago)
- Last Synced: 2024-10-11T11:44:24.948Z (27 days ago)
- Topics: django, django-application, django-project, django-rest-framework, python, python-django-bootstrap, python3, tailwind, tailwindcss, weather-api, weather-app
- Language: Python
- Homepage:
- Size: 468 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ClimaVibe-WeatherApp-Django
**ClimaVibe** is a Django-based weather application that provides real-time weather information for predefined cities as well as any city entered by the user. The app uses the OpenWeather API to fetch weather data such as temperature, weather description, and corresponding weather icons.
## Features
- **Real-time Weather Data**: Fetches current weather information for any city using the OpenWeather API.
- **Predefined Cities**: Displays weather data for predefined cities on the homepage.
- **User Input**: Allows users to search for the weather in any city.
- **Responsive Design**: The UI is styled using Tailwind CSS for a modern and responsive user experience.
- **Dynamic Background**: The background of the app adapts to the current weather condition.
## Technologies Used
- **Django**: Backend framework for handling views, models, and routing.
- **Python**: Programming language used for logic implementation.
- **OpenWeather API**: API service to fetch weather data.
- **Tailwind CSS**: Utility-first CSS framework used for styling.
- **HTML/CSS**: For structuring and designing the user interface.
## Setup Instructions
1. **Clone the Repository**:
```bash
git clone https://github.com/Himel-Sarder/ClimaVibe-WeatherApp-Django.git
```
2. **Install Dependencies**:
Ensure you have Python and Django installed. You can install the required packages using `pip`:
```bash
pip install django requests
```
3. **Set Up the OpenWeather API Key**:
- Create a `.env` file in the root directory.
- Add your OpenWeather API key:
```
OPENWEATHER_API_KEY=your_api_key_here
```
- If using Django environment settings, you might need to configure the settings to read this key.
4. **Migrate Database**:
```bash
python manage.py migrate
```
5. **Create Superuser** (for admin panel access):
```bash
python manage.py createsuperuser
```
6. **Run the Server**:
```bash
python manage.py runserver
```
7. **Access the Application**:
Open your web browser and go to:
```
http://127.0.0.1:8000/
```
## Admin Panel
The admin panel allows you to manage predefined cities for which the weather data is displayed on the homepage.
- **Access the Admin Panel**:
```
http://127.0.0.1:8000/admin/
```
Use the superuser credentials created during setup.
- **Add/Remove Predefined Cities**:
- Go to the `Predefined Cities` section in the admin panel.
- Add or remove cities as needed. The app will automatically fetch and display the weather data for these cities on the homepage.
## Customization
- **Adding More Predefined Cities**:
- You can add more cities in the admin panel as mentioned above, or modify the `predefined_cities` list in the `index` view.
- **Styling**:
- The app uses Tailwind CSS for styling. You can customize the look and feel by modifying the `index.html` and the custom styles in the `style` tag.
## Contributing
Feel free to fork this repository and submit pull requests. For major changes, please open an issue first to discuss what you would like to change.
## License
This project is licensed under the MIT License.
# Thank You 😻🤍