Skip to content
Smog Alert App provides real-time air pollution data all around the world and shows nearby polluters.
Branch: master
Clone or download
Latest commit 10d89cc Sep 17, 2018

README.md

License Github Releases

We’ve created this application, because we believe that nobody should be allowed to burn garbage in their houses – that’s dangerous for the environment and everybody’s health. Smog Alert App works on each mobile platform - it is based on React Native, licensed under the MIT license.


Note: This project was bootstrapped with Create React Native App. Below you'll find information about performing common tasks. The most recent version of this guide is available here.

Contributing

Bug reporting

Github Open Issues Github Closed Issues Github Pull Requests

We want contributing to Smog Alert App to be fun, enjoyable, and educational for everyone. Changes and improvements are more than welcome! Feel free to fork and open a pull request. If you have found any issues, please report them here - they are being tracked on GitHub Issues.

License

Smog Alert App was created and developed by Bartosz Łaniewski. The full list of contributors can be found here. Smog Alert App's code is MIT licensed. Icons made by ssnjrthegr8. Air quality data is licensed under the Creative Commons Attribution 4.0 Generic License. It is attributed to the OpenAQ community.

Development

We have prepared multiple commands to help you develop Smog Alert App on your own. You will need a local copy of Node.js installed on your machine. First, you need to clone or download our repository:

$ git clone --depth=1 https://github.com/Bartozzz/smog-alert-app.git smog-alert-app

…and install dependencies with npm:

$ npm install

Usage

$ npm run <command>

List of commands

Command Description
start Runs your app in development mode. Open it in the Expo app on your phone to view it. It will reload if you save edits to your files, and you will see build errors and logs in the terminal. Sometimes you may need to reset or clear the React Native packager's cache. To do so, you can pass the --reset-cache flag to the start script.
ios Like npm start, but also attempts to open your app in the iOS Simulator if you're on a Mac and have it installed.
android Like npm start, but also attempts to open your app on a connected Android device or emulator. Requires an installation of Android build tools (see React Native docs for detailed setup).
eject This will start the process of "ejecting" from build scripts. You'll be asked a couple of questions about how you'd like to build your project.

Warning: Running eject is a permanent action (aside from whatever version control system you use). An ejected app will require you to have an Xcode and/or Android Studio environment set up.

Troubleshooting

Networking

If you're unable to load your app on your phone due to a network timeout or a refused connection, a good first step is to verify that your phone and computer are on the same network and that they can reach each other. App needs access to ports 19000 and 19001 so ensure that your network and firewall settings allow access from your device to your computer on both of these ports. Try opening a web browser on your phone and opening the URL that the packager script prints, replacing exp:// with http://. So, for example, if underneath the QR code in your terminal you see:

exp://192.168.0.1:19000

Try opening Safari or Chrome on your phone and loading:

http://192.168.0.1:19000
http://192.168.0.1:19001

If you're not able to load the http URL in your phone's web browser, try using the tethering/mobile hotspot feature on your phone (beware of data usage, though), connecting your computer to that WiFi network, and restarting the packager. If you are using a VPN you may need to disable it.

You can’t perform that action at this time.