{"id":18900451,"url":"https://github.com/sergio-usma/airpoll-colombia-app","last_synced_at":"2025-10-29T17:03:15.592Z","repository":{"id":185724377,"uuid":"673979814","full_name":"sergio-usma/airpoll-colombia-app","owner":"sergio-usma","description":"AirPoll is a project that aims to provide information about the air quality in the most important cities in Colombia. Besides the Air Quality Index, the API returns data about polluting gases, such as Carbon monoxide (CO), Nitrogen monoxide (NO), Nitrogen dioxide (NO2), Ozone (O3), Sulphur dioxide (SO2), Ammonia (NH3), and particulates (PM2.5 PM10)","archived":false,"fork":false,"pushed_at":"2023-08-05T19:39:24.000Z","size":191,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-23T10:02:01.559Z","etag":null,"topics":["air-quality","microverse","react"],"latest_commit_sha":null,"homepage":"https://airpollution-colombia.netlify.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sergio-usma.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-08-02T21:39:01.000Z","updated_at":"2023-08-31T23:17:11.000Z","dependencies_parsed_at":null,"dependency_job_id":"ad5b7b0f-d937-46fa-876a-73b32dd38888","html_url":"https://github.com/sergio-usma/airpoll-colombia-app","commit_stats":{"total_commits":112,"total_committers":2,"mean_commits":56.0,"dds":"0.017857142857142905","last_synced_commit":"959a56b2fd0035d3095ec93ee2a7f690044acdc2"},"previous_names":["sergio-usma/airpoll-colombia-app"],"tags_count":0,"template":false,"template_full_name":"sergio-usma/react-cra-template","purl":"pkg:github/sergio-usma/airpoll-colombia-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio-usma%2Fairpoll-colombia-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio-usma%2Fairpoll-colombia-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio-usma%2Fairpoll-colombia-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio-usma%2Fairpoll-colombia-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sergio-usma","download_url":"https://codeload.github.com/sergio-usma/airpoll-colombia-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sergio-usma%2Fairpoll-colombia-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276554029,"owners_count":25662960,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-23T02:00:09.130Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["air-quality","microverse","react"],"created_at":"2024-11-08T08:51:19.823Z","updated_at":"2025-09-23T10:03:13.076Z","avatar_url":"https://github.com/sergio-usma.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ca id=\"readme-top\"\u003e\u003c/a\u003e\n\u003cdiv align=\"center\"\u003e\n  \u003c!-- You are encouraged to replace this logo with your own! Otherwise you can also remove it. --\u003e\n  \u003cimg src=\"./src/assets/logo.png\" alt=\"logo\" width=\"140\"  height=\"auto\" /\u003e\n  \u003cbr/\u003e\n\n\u003ch3\u003e\u003cb\u003eAir Pollution Colombia\u003c/b\u003e\u003c/h3\u003e\n\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\n# 📗 Table of Contents\n\n- [📖 About the Project](#about-project)\n    - [🛠 Built With](#built-with)\n        - [Tech Stack](#tech-stack)\n        - [Key Features](#key-features)\n    - [🚀 Live Demo](#live-demo)\n- [💻 Getting Started](#getting-started)\n    - [Setup](#setup)\n    - [Prerequisites](#prerequisites)\n    - [Install](#install)\n    - [Usage](#usage)\n    - [Run tests](#run-tests)\n    - [Deployment](#deployment)\n- [👥 Authors](#authors)\n- [🔭 Future Features](#future-features)\n- [🤝 Contributing](#contributing)\n- [⭐️ Show your support](#support)\n- [🙏 Acknowledgements](#acknowledgements)\n- [❓ FAQ (OPTIONAL)](#faq)\n- [📝 License](#license)\n\n\u003c!-- PROJECT DESCRIPTION --\u003e\n\n# 📖 AirPoll Colombia \u003ca id=\"about-project\"\u003e\u003c/a\u003e\n\n**AirPoll** is a project that aims to provide information about the air quality in the most important cities in Colombia. Besides the Air Quality Index, the API returns data about polluting gases, such as Carbon monoxide (CO), Nitrogen monoxide (NO), Nitrogen dioxide (NO2), Ozone (O3), Sulphur dioxide (SO2), Ammonia (NH3), and particulates (PM2.5 and PM10).\n\n## 🛠 Built With \u003ca id=\"built-with\"\u003e\u003c/a\u003e\n\n### Tech Stack \u003ca id=\"tech-stack\"\u003e\u003c/a\u003e\n\nThe application was built using the following technologies:\n\n  \u003cul\u003e\n    \u003cli\u003e\u003ca href=\"https://www.w3.org/html/\"\u003eHTML5\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.w3schools.com/css/\"\u003eCSS3\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://reactjs.org/\"\u003eReact.js\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://redux.js.org/\"\u003eRedux\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.javascript.com/\"\u003eJavaScript\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"https://www.npmjs.com/\"\u003eNPM\u003c/a\u003e\u003c/li\u003e\n  \u003c/ul\u003e\n\n\u003c!-- Features --\u003e\n\n### Key Features \u003ca id=\"key-features\"\u003e\u003c/a\u003e\n\nThe following features are available:\n- **Filter a city by query using the searchbar**\n- **Render the most important cities in Colombia, with location and population data**\n- **Get the Air Quality Index (AQI) of a city from the OpenWeather API**\n- **Render the most important polluting gases in a city**\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- LIVE DEMO --\u003e\n\n## 🚀 Live Demo \u003ca id=\"live-demo\"\u003e\u003c/a\u003e\n\n- [Click here](https://airpollution-colombia.netlify.app/) to see the live demo on Netlify.com\n- [Click here](https://www.loom.com/share/9c56c18a935d4327810e737f6ff9e979?sid=fb54579c-d596-4094-9876-5717154ac6ec) to see a video presentation of the project\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- GETTING STARTED --\u003e\n\n## 💻 Getting Started \u003ca id=\"getting-started\"\u003e\u003c/a\u003e\n\nTo get a local copy up and running, follow these steps.\n\n### Prerequisites\n\nIn order to run this project you need:\n\n```sh\nnpm install -g node\n```\n\n### Setup\n\nClone this repository to your desired folder:\n\n```sh\n  cd my-folder\n  git clone git@github.com:sergio-usma/airpoll-colombia-app.git\n```\n\n### Install\n\nInstall this project with:\n    \n```sh\nnpm install\n```\n\n### Usage\n\nTo run the project, execute the following command:\n\n```sh\nnpm start\n```\n\n### Run tests\n\nTo run tests, run the following command:\n\n```sh\nnpm run test\n```\n\n### Deployment\n\nYou can deploy this project using:\n\n```sh\nnpm run build\n```\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- AUTHORS --\u003e\n\n## 👥 Authors \u003ca id=\"authors\"\u003e\u003c/a\u003e\n\n👤 **Author**\n\n- GitHub: [@sergio-usma](https://github.com/sergio-usma)\n- Twitter: [@VonUsma](https://twitter.com/vonusma)\n- LinkedIn: [Sergio Andres Usma](https://www.linkedin.com/in/sergiousma/)\n\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- FUTURE FEATURES --\u003e\n\n## 🔭 Future Features \u003ca id=\"future-features\"\u003e\u003c/a\u003e\n\n- [ ] **Add more countries data**\n- [ ] **Generate a comparative graph about changes through the time**\n- [ ] **Add a better UI/UX design**\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- CONTRIBUTING --\u003e\n\n## 🤝 Contributing \u003ca id=\"contributing\"\u003e\u003c/a\u003e\n\nContributions, issues, and feature requests are welcome!\n\nFeel free to check the [issues page](../../issues/).\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- SUPPORT --\u003e\n\n## ⭐️ Show your support \u003ca id=\"support\"\u003e\u003c/a\u003e\n\nIf you like this project, please consider supporting us! Your support helps us to continue developing and improving our project for everyone to enjoy. Whether it's a small donation, sharing the project with your friends, or contributing your skills and expertise, every little bit makes a huge difference. With your support, we can create something truly amazing together. Thank you for being a part of our community and helping us to make a difference!\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- ACKNOWLEDGEMENTS --\u003e\n\n## 🙏 Acknowledgments \u003ca id=\"acknowledgements\"\u003e\u003c/a\u003e\n\nI would like to thank Microverse for this amazing opportunity to learn with them and for the support they give me to make this possible. Besides I want to recognize the [Original design](https://www.behance.net/gallery/31579789/Ballhead-App-(Free-PSDs)) idea by [Nelson Sakwa on Behance](https://www.behance.net/sakwadesignstudio).\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- FAQ (optional) --\u003e\n\n## ❓ FAQ (OPTIONAL) \u003ca id=\"faq\"\u003e\u003c/a\u003e\n\n- **How do I set up the project?**\n\n    - Clone the repository from GitHub.\n\n- **How can I contribute to the project?**\n\n    1. Fork the repository on GitHub.\n    2. Create a new branch for your changes using git checkout -b my-feature-branch.\n    3. Make your changes and commit them with descriptive commit messages.\n    4. Push your changes to your forked repository.\n    5. Submit a pull request to the original repository.\n    6. Wait for feedback and iterate on your changes as needed.\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n\n\u003c!-- LICENSE --\u003e\n\n## 📝 License \u003ca id=\"license\"\u003e\u003c/a\u003e\n\nThis project is [MIT](./LICENSE) licensed.\n\n\u003cp align='right'\u003e(\u003ca href=\"#readme-top\"\u003eback to top\u003c/a\u003e)\u003c/p\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergio-usma%2Fairpoll-colombia-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsergio-usma%2Fairpoll-colombia-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsergio-usma%2Fairpoll-colombia-app/lists"}