Skip to content

ju5tyn/WeatherBoard

Repository files navigation


Logo

WeatherBoard

Beautiful weather app built in Swift.

Report Bug · Request Feature

About The Project

Logo

This was originally just a simple design idea of mine, created in 2018. After learning Swift I decided I wanted to make it a reality.

The project uses Realm for data persistence, and the OpenWeatherMap API for fetching Weather Data.

A problem with many weather apps that I have used is that they take a long amount of time to load, and end up bombarding the user with a mass of information. My main goal with this app was to make the most important weather information be available to the user at a glance, with the option to expand to see further details.

Another aim of this project was to reduce usage of static image assets as much as possible. Currently the only images being used in this app are for weather condition icons, with everything else ranging from gradient backgrounds, to condition effects, to custom buttons all being rendered natively using Core Graphics and Core Animation.

Demo

Logo

Installation

Setting up and building the project locally requires a few prerequisites.

  1. Install CocoaPods if not already installed
sudo gem install cocoapods
  1. Clone the repo
git clone https://github.com/ju5tyn/WeatherBoard.git
  1. Install CocoaPod packages in project directory
pod install
  1. In the 'Constants' folder, create a new file called 'Keys.swift'

  2. Head over to openweathermap.com, and register for an API key (free)

  3. In keys.swift, add your key:

struct Keys{
	static let openweathermap = [ENTER YOUR KEY HERE]
}

The project will now be fully usable.

Roadmap

See the open issues for a list of proposed features (and known issues).

Contact

Email: justynlive@gmail.com

My Website and Portfolio: justynhenman.com

Acknowledgements

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.