lucasmontano / openweathermap-ios

Weather, everybody wants to know how it is going to be during the week. Will it be rainy, windy, or sunny? Luckily for us, in the information age, there are open APIs to retrieve information about it.

iOS OpenWeather App

OpenWeather is a project created by Lucas Montano initially as an One-Day-Challange, then he decided to create an Open Source project to help his followers and everyone getting started with Open Source world world building a basic but very strategic application!

---

Table of Contents

• Getting Started
• Features
• Contributing
• Support
• License
• Other Platforms

---

🚀 Getting Started

Prerequisites

• To run any iOS application built with Swift you need to configure the environment on your machine.

• Xcode 11.0, *

• Homebrew

Clone

• Clone this repo to your local machine using:

https://github.com/lucasmontano/openweathermap-ios

Setup

iOS (MAC Only)

Needs complementation

---

📋 Features

Documentation

• Explore the Earth Weather forecast (Real Time)
• Check detailed information about the weather by coordinates (lat, lon)
• Bookmark a location
• Visualize all bookmarked locations in the map
• Remove a bookmark
• Data Cache
• Theme Switcher (Light/Dark Mode)
• One way data flow (implement a state reducer)
• Unique source of truth, implementing a centralized repository
• Search functionality
• Five+ days forecast
• Write some tests (of course)

Build with

• Core:
  • Swift - A powerful open language that lets everyone build amazing apps.
• Linting:
  • SwiftLint - A tool to enforce Swift style and conventions.

---

🤔 Contributing

To get started...

Step 1

• 🍴 Fork this repo!

Step 2

• 👯 Clone this repo to your local machine using https://github.com/luacasmontano/openweathermap-ios.git

Step 3

• 🎨 Install SwiftLint with homebrew using brew install swiftlint

Step 4

• 🎋 Create your feature branch using git checkout -b my-feature

Step 5

• ✅ Commit your changes using git commit -m 'feat: My new feature';

Step 6

• 📌 Push to the branch using git push origin my-feature;

Step 7

• 🔃 Create a new pull request

After your Pull Request is merged, can you delete your feature branch.

---

📌 Support

Reach out to me at one of the following places!

• Twitter at @lucas_montano
• Instagram at @lucasmontano
• Linkedin at Lucas Montano
• Youtube at Lucas Montano

---

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

⚒ Other Platforms

Open Weather on Other Platforms:

• Android: https://github.com/lucasmontano/openweathermap
• React Native: https://github.com/lucasmontano/openweathermap-reactnative
• Flutter: https://github.com/lucasmontano/openweathermap-flutter

---

Made with ♥ Enjoy it!