Giter Club home page Giter Club logo

aqi-air-quality-near-me's Introduction

project-logo

AQI: Air Quality Near Me

Breathe easy! Get Real-time air quality & personalized health tips.


Table of Contents

๐Ÿ“ Overview

Breathe easy, breathe informed: AQI: Air Quality Near Me Concerned about air quality? AQI: Air Quality Near Me is your one-stop solution for real-time information and personalized health advice.

๐Ÿงฉ Features

  • Instant air quality: No more guesswork! Get the current AQI index for your exact location or search any city worldwide.
  • Detailed breakdown: See levels of key pollutants like PM2.5, ozone, and more, and understand their impact on your health.
  • Health recommendations tailored to you: Get personalized advice based on the AQI and your health profile.
  • Plan your day effectively: Choose outdoor activities with confidence based on air quality conditions.
  • Protect your health: Receive timely alerts and recommendations for sensitive groups like children, pregnant women, and those with respiratory conditions.
  • Stay informed: Track air quality trends and historical data to understand patterns and make informed decisions.

๐Ÿ—‚๏ธ Repository Structure

โ”œโ”€โ”€ assets
โ”‚   โ”œโ”€โ”€ logo
โ”‚   โ”‚   โ””โ”€โ”€ logo.png
โ”‚   โ””โ”€โ”€ svg
โ”‚       โ””โ”€โ”€ *.svg
โ”œโ”€โ”€ lib
โ”‚   โ”œโ”€โ”€ src
โ”‚   โ”‚   โ”œโ”€โ”€ cubit
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ waqi_cubit.dart
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ waqi_state.dart
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ aqi_search_cubit.dart
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ aqi_search_state.dart
โ”‚   โ”‚   โ”œโ”€โ”€ data
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ data.dart
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ table_models.dart
โ”‚   โ”‚   โ”œโ”€โ”€ models
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ aqi_response.dart
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ failure.dart
โ”‚   โ”‚   โ”œโ”€โ”€ presentation
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ components
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ about_widget.dart
โ”‚   โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ pollutant_amount_box.dart
โ”‚   โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ pollutant_info_box.dart
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ app.dart
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ aqi_page.dart
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ home_page.dart
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ search_page.dart
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ settings_page.dart
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ tab_page.dart
โ”‚   โ”‚   โ”œโ”€โ”€ repositories
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ waqi_repository.dart
โ”‚   โ”œโ”€โ”€ main.dart
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ .env
โ”œโ”€โ”€ analysis_options.yaml
โ”œโ”€โ”€ pubspec.yaml
โ””โ”€โ”€ README.md

โš™๏ธ Installation

  1. Clone the repository
    git clone https://github.com/ikramhasan/aqi-air-quality-near-me.git
  2. Install the dependencies
    flutter pub get
  3. Run the app
    flutter run

๐Ÿค Contributing

Contributions are welcome! Here are several ways you can contribute:

Contributing Guidelines
  1. Fork the Repository: Start by forking the project repository to your local account.
  2. Clone Locally: Clone the forked repository to your local machine using a git client.
    git clone https://github.com/ikramhasan/aqi-air-quality-near-me.git
  3. Create a New Branch: Always work on a new branch, giving it a descriptive name.
    git checkout -b new-feature-x
  4. Make Your Changes: Develop and test your changes locally.
  5. Commit Your Changes: Commit with a clear message describing your updates.
    git commit -m 'Implemented new feature x.'
  6. Push to local: Push the changes to your forked repository.
    git push origin new-feature-x
  7. Submit a Pull Request: Create a PR against the original project repository. Clearly describe the changes and their motivations.
  8. Review: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!

๐ŸŽ— License

This project is protected under the Apache License 2.0 License. For more details, refer to the LICENSE file.

Return

aqi-air-quality-near-me's People

Contributors

ikramhasan avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.