{"id":22666709,"url":"https://github.com/kareem-aez/weatherly","last_synced_at":"2025-03-29T10:16:26.668Z","repository":{"id":265454915,"uuid":"896027603","full_name":"Kareem-AEz/weatherly","owner":"Kareem-AEz","description":"Weatherly is a JavaScript-powered weather and location tracker app that brings real-time weather updates, intuitive geolocation, and a smooth user experience. With its dynamic features, Weatherly is designed to make weather tracking interactive and straightforward.","archived":false,"fork":false,"pushed_at":"2024-12-13T13:56:28.000Z","size":216,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-04T04:07:39.183Z","etag":null,"topics":["ajax","api","javascript"],"latest_commit_sha":null,"homepage":"https://kareem-aez.github.io/weatherly/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kareem-AEz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-29T11:57:09.000Z","updated_at":"2024-12-13T13:56:31.000Z","dependencies_parsed_at":"2024-11-29T13:31:35.976Z","dependency_job_id":null,"html_url":"https://github.com/Kareem-AEz/weatherly","commit_stats":null,"previous_names":["kareem-aez/weatherly"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kareem-AEz%2Fweatherly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kareem-AEz%2Fweatherly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kareem-AEz%2Fweatherly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kareem-AEz%2Fweatherly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kareem-AEz","download_url":"https://codeload.github.com/Kareem-AEz/weatherly/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246168106,"owners_count":20734390,"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","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":["ajax","api","javascript"],"created_at":"2024-12-09T14:18:17.602Z","updated_at":"2025-03-29T10:16:26.632Z","avatar_url":"https://github.com/Kareem-AEz.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Sendy](assets/weatherly-og.jpg)\n\n# 🌦️ Weatherly: A Dynamic Weather and Location Tracker\n\n**Weatherly** is a JavaScript-powered weather and location tracker app that brings real-time weather updates, intuitive geolocation, and a smooth user experience. With its dynamic features, Weatherly is designed to make weather tracking interactive and straightforward.\n\n---\n\n## 🌟 Features\n\n- **Real-Time Weather Updates**  \n  Fetch weather data for any location using [Open-Meteo API](https://open-meteo.com) with hourly details like temperature and wind speed.\n\n- **Geolocation Services**  \n  Automatically determine your location using the browser's geolocation API and reverse geocode it to provide weather details.\n\n- **Favorites Management**  \n  Add and organize favorite locations with a clean UI, enabling quick weather checks for saved locations.\n\n- **Search Functionality**  \n  Find locations worldwide through [OpenStreetMap Nominatim](https://nominatim.openstreetmap.org/) with error handling for invalid inputs.\n\n- **Interactive Map Integration**  \n  Visualize locations on an embedded map powered by **Leaflet.js**, with smooth zooming and panning transitions.\n\n- **Persistent Local Storage**  \n  Save your favorite locations in the browser using `localStorage`, ensuring data remains between sessions.\n\n---\n\n## 🛠️ Technologies Used\n\n- **JavaScript (ES6+)**  \n  Leveraging classes, promises, and async/await for modular, maintainable, and dynamic code.\n\n- **APIs**:\n  - [Open-Meteo](https://open-meteo.com): Weather data with hourly and current forecasts.\n  - [BigDataCloud](https://www.bigdatacloud.com/): Reverse geocoding for human-readable addresses.\n  - [OpenStreetMap Nominatim](https://nominatim.openstreetmap.org/): Forward geocoding for search functionality.\n\n- **Leaflet.js**  \n  For interactive map rendering and geospatial data visualization.\n\n- **CSS**  \n  Custom styles for polished visuals, though the app is not yet responsive.\n\n---\n\n## 📂 File Structure\n- `app.js`: Core logic including classes for APIs, geolocation, weather, and UI rendering.\n- `index.html`: Base structure of the application.\n- `styles.css`: Custom styles for the application.\n- `sprite.svg`: SVG icons used across the application.\n\n---\n\n### Key Components\n\n- **`app.js`**  \n  Contains the core logic, organized into classes:\n  - `APIWorker`: Handles API requests and responses.\n  - `GeoLocation`: Manages geolocation and reverse geocoding.\n  - `Weather`: Fetches weather data.\n  - `UI`: Updates the UI dynamically and manages feedback messages.\n  - `App`: Orchestrates the app, initializes features, and binds event listeners.\n\n- **`styles.css`**  \n  Handles visual design for the application, including styles for the map, loaders, buttons, and weather cards.\n\n---\n\n## 🤝 Contributing\nContributions are welcome! If you'd like to improve this app or add new features:\n\n- Fork the repository.\n- Create a new branch (git checkout -b feature-name).\n- Commit your changes (git commit -m \"Add feature\").\n- Push to the branch (git push origin feature-name).\n- Open a pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkareem-aez%2Fweatherly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkareem-aez%2Fweatherly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkareem-aez%2Fweatherly/lists"}