Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bahertamer/skycast

Skycast is an iOS weather forecast app using Combine & SwiftUI
https://github.com/bahertamer/skycast

combine openweathermap swift swiftui

Last synced: 19 days ago
JSON representation

Skycast is an iOS weather forecast app using Combine & SwiftUI

Host: GitHub
URL: https://github.com/bahertamer/skycast
Owner: BaherTamer
License: mit
Created: 2023-09-11T10:32:34.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2023-10-01T18:15:47.000Z (over 1 year ago)
Last Synced: 2023-10-01T21:42:34.506Z (over 1 year ago)
Topics: combine, openweathermap, swift, swiftui
Language: Swift
Homepage: https://youtu.be/EKfTAnE8Y2M
Size: 14.7 MB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        ![Cover](Screenshots/Cover.jpg)




# ⛅️ Skycast

Skycast is an iOS weather forecast app using **Combine** & **SwiftUI**. The project was developed as my graduation project from [Robusta Studio](https://robustagroup.com) internship program in 2023. For a deeper understanding of the project's requirements and functionalities, check out the requirements file [here](Requirements.md).




## ▶️ Demo

Watch the demo video on [YouTube](https://youtu.be/EKfTAnE8Y2M).




## 🌟 Features

- Display weather information based on your current location

- Search for a city to display weather information for

- Searched cities are save locally on your device

- Display weather temperature, conditions, and information

- Display weather information for the upcoming days

- Update application temperature degree preferences (Celsius/Fahrenheit)

- Update application color scheme preferences (Light/Dark Mode)

- Set a daily reminder to check today's weather

- Application supports Arabic/English localization




## 🖼️ Screenshots

### ☀️ Light Mode

| **Today Forecast** | **Daily Forecast** | **Add City** | **Settings** |

| ------------------ | ------------------ | ------------ | ------------ |

| ![Main](Screenshots/Light/Main.png) | ![Daily](Screenshots/Light/Daily.png) | ![Cities](Screenshots/Light/Cities.png) | ![Settings](Screenshots/Light/Settings.png) |

### 🌙 Dark Mode

| **Today Forecast** | **Daily Forecast** | **Add City** | **Settings** |

| ------------------ | ------------------ | ------------ | ------------ |

| ![Main](Screenshots/Dark/Main.png) | ![Daily](Screenshots/Dark/Daily.png) | ![Cities](Screenshots/Dark/Cities.png) | ![Settings](Screenshots/Dark/Settings.png) |

### 🌍 Localization

| **Settings** | **Add City** | **Daily Forecast** | **Today Forecast** |

| ------------ | ------------ | ------------------ | ------------------ |

| ![Main](Screenshots/Arabic/Settings.png) | ![Daily](Screenshots/Arabic/Cities.png) | ![Cities](Screenshots/Arabic/Daily.png) | ![Settings](Screenshots/Arabic/Main.png) |

### 🌡️ Weather Conditions

| **Clear** | **Rain** | **Clouds** |

| --------- | -------- | ---------- |

| ![Main](Screenshots/Conditions/Clear.png) | ![Daily](Screenshots/Conditions/Rain.png) | ![Cities](Screenshots/Conditions/Clouds.png) |

### 🔁 Landscape Mode

| **English** | **Arabic** |

| ----------- | ---------- |

| ![Main](Screenshots/Landscape/English.png) | ![Daily](Screenshots/Landscape/Arabic.png) |




## ☁️ API

This project uses the [OpenWeather](https://openweathermap.org) One Call API 3.0.




## 🛠️ Tools

- Swift

- SwiftUI

- Combine

- UserDefaults

- Local Notification

- Localization

- Network

- Core Location




## 🏗️ Architecture

This app uses MVVM (Model - View - View Model) architectural pattern.




![MVVM Architectural Pattern](Screenshots/MVVM.jpg)




## 🗂️ Project Structure

```

    Skycast                          # Root Group

    .

    ├── Presentation                 # Organizing views and view-related components

    |   ├── Shared Components        # Components that used by multiple views

    |   └── Scenes                   # All interface screens

    |       └── Scene                # A scene that represents single screen/feature

    |           ├── Components       # Related components for a scene

    |           ├── Views            # SwiftUI Views for a scene

    |           └── View Models      # View Models for a SwiftUI view

    ├── Models                       # Data models and entities

    ├── Managers                     # Managers for data, network requests, or other complex operations

    ├── Services                     # API services for fetching data

    ├── Extensions                   # Useful extensions for presentation

    ├── Utilities                    # Utilities for fetching data and presentation layout

    ├── Globals                      # App constants

    └── Localizable                  # localization strings

```




## ⚖️ License

```

    MIT License

    

    Copyright (c) 2023 Baher Tamer

    

    Permission is hereby granted, free of charge, to any person obtaining a copy

    of this software and associated documentation files (the "Software"), to deal

    in the Software without restriction, including without limitation the rights

    to use, copy, modify, merge, publish, distribute, sublicense, and/or sell

    copies of the Software, and to permit persons to whom the Software is

    furnished to do so, subject to the following conditions:

    

    The above copyright notice and this permission notice shall be included in all

    copies or substantial portions of the Software.

    

    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR

    IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

    FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE

    AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER

    LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,

    OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE

    SOFTWARE.

```