Skip to content

Endiong/air_quality_app

Repository files navigation

AirQuality Project Overview

The AirQuality Project is a web-based application designed to provide users with real-time air quality data for various locations worldwide. The goal of this project is to promote environmental awareness by making air quality information accessible and visually understandable to everyone.

Users can view the Air Quality Index (AQI), pollutant concentrations, and overall environmental health indicators through a clean and responsive interface.

Features

Real-time air quality monitoring by city or location

Dynamic data visualization with color-coded indicators

Search functionality for specific regions or cities

Responsive interface suitable for mobile and desktop devices

API integration for live environmental data

Technologies Used

Frontend: HTML, CSS, JavaScript

Backend: Flask

API: OpenWeatherMap Air Pollution API

Hosting/Deployment: Render

Version Control: Git and GitHub

Installation and Setup

To run this project locally:

Clone the repository

git clone https://github.com/Endiong/AirQuality.git

Navigate to the project directory

cd AirQuality

Open the main HTML file Open index.html directly in your browser. (If the project includes a backend, follow the setup instructions below.)

Live Demo

The project is deployed and accessible at: https://breatheeasy-llhr.onrender.com

Future Improvements

Add historical air quality trends with graph visualization

Integrate local weather information alongside AQI data

Implement user authentication for personalized dashboards

Enable multilingual support for broader accessibility

Contributing

Contributions are welcome. To contribute:

Fork the repository

Create a new branch (git checkout -b feature-name)

Make your modifications

Commit and push your changes (git push origin feature-name)

Open a Pull Request

License

This project is licensed under the MIT License. You are free to use, modify, and distribute this project for both personal and commercial purposes, provided that proper credit is given to the original author.

See the LICENSE file for details.

Author

Endiong David Ekponne GitHub: https://github.com/Endiong

Email: [email protected]

Acknowledgements

OpenWeatherMap API for air quality data

Render for free deployment hosting

All contributors and testers who supported project development

About

An air quality web

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published