Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alpha037/atlas-weather-app
A minimalist asynchronous weather application.
https://github.com/alpha037/atlas-weather-app
autocomplete-search express expressjs google-places-api handlebars mapbox-api node nodejs weather-app weather-forecast weatherstack-api
Last synced: 9 days ago
JSON representation
A minimalist asynchronous weather application.
- Host: GitHub
- URL: https://github.com/alpha037/atlas-weather-app
- Owner: alpha037
- License: agpl-3.0
- Created: 2020-05-01T12:04:30.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-09-14T06:58:56.000Z (over 1 year ago)
- Last Synced: 2024-11-13T22:48:42.564Z (2 months ago)
- Topics: autocomplete-search, express, expressjs, google-places-api, handlebars, mapbox-api, node, nodejs, weather-app, weather-forecast, weatherstack-api
- Language: JavaScript
- Homepage: http://weather.shubhranil.com
- Size: 1.47 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Atlas Weather-App
A minimalist asynchronous weather application.
#### Deployed at: http://weather.shubhranil.com/
#### Help:
You can use this web app to find out the weather of any place in real time. Just type in the name of the place in the search bar and see the magic happen.
# Features include:
- Complete location of the searched place.
- Local time of the place, Date and the present weather forecast in that region.
- Autocomplete feature powered by Google Places API (sometimes it won't work due to API traffic or daily API calls limit or a number of other reasons) and Weather based real-time icons (if available).
# Docker Instructions
If you haven't installed [Docker](https://www.docker.com/products/docker-desktop) already, then you can get it from [here](https://www.docker.com/products/docker-desktop). After installing it, create an account in Docker and copy the username.
Before running this application in docker, make sure to replace the **API KEYS** placeholder with your own.
This application is already dockerized. You can pull the image directly from [docker hub](https://hub.docker.com/u/alpha037):
```bash
docker pull alpha037/atlas-weather-app
```
**OR**
You can create your own by following the given steps.
To run the app as a docker container, follow the given steps:
- Navigate to the project directory
```bash
cd atlas-weather-app
```
- Replace USERNAME with your own username and build the docker image
```bash
docker build -t /atlas-weather-app:1.0 .
```
- Open up the terminal at the project directory, replace USERNAME with your own username and run the following command:
```bash
docker run -p 3000:3000 /atlas-weather-app:1.0
```
- You can also use docker compose to manage your containers:
```bash
docker-compose up
```
and
```bash
docker-compose down
```
# Contributing
Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are **greatly appreciated**. For more details, check out the [contributing guidelines](CONTRIBUTING.md).
1. Fork the Project.
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`).
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`).
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request.
# License
Distributed under GNU AGPL 3.0. See [LICENSE](LICENSE) for more information.
# Contact
Shubhranil Dutta - [email protected]
Project Link: [https://github.com/alpha037/atlas-weather-app](https://github.com/alpha037/atlas-weather-app)