Skip to content

Weather App designed for iOS 17+ which uses OpenWeatherAPI for accurate information.

License

Notifications You must be signed in to change notification settings

keremsemiz/SwiftWeatherApp

Repository files navigation

🌤️ SwiftWeatherApp: Beautiful yet Simple iOS Weather App

License Contributors Issues Forks Stars

A sleek and minimalistic weather application for iOS that provides accurate weather information using the OpenWeatherMap API.

App Screenshot

🚀 Features

  • 🌍 Current Location Weather: Get real-time weather updates based on your current location.
  • 🏙️ Search for Cities: Input any city name to retrieve its weather data.
  • 🔄 Refresh with a Swipe: Easily refresh the weather data with a simple gesture.
  • 📊 Detailed Weather Information: View temperature, humidity, wind speed, and more.

🛠️ Tech Stack

  • Language: Swift
  • Framework: SwiftUI
  • API: OpenWeatherMap API
  • Platform: iOS 17+

📋 Prerequisites

Before you begin, ensure you have met the following requirements:

  • 📱 iOS device or simulator running on macOS.
  • 🛠️ Xcode (version 13.0 or above).
  • 🌐 OpenWeatherMap API Key (you’ll need to generate your API key).

🛑 Permissions

To fully use the app, ensure the following permissions are granted:

  • Location Access: To fetch weather data for your current location.

⚙️ Installation & Setup

Follow these steps to get the app up and running:

  1. Clone the repository:
    git clone https://github.com/keremsemiz/SwiftWeatherApp.git
  2. Open the project in Xcode: Open SwiftWeatherApp.xcodeproj in Xcode.
  3. Install Xcode Developer Tools: Xcode should prompt you to install necessary tools. If not, you can install them via Xcode > Preferences > Downloads.
  4. Simulate the App: Choose a simulator (or your connected device) and press Cmd + R to run the app.
  5. Set your API Key: Go to Constants.swift and replace YOUR_API_KEY with your OpenWeatherMap API Key.

📱 How to Use the App

Once the app is installed, follow these simple steps:

  1. Allow location permissions: On the first launch, allow the app to access your current location.
  2. Search for a city: Enter any city name in the search bar or use your current location to get weather updates.
  3. Refresh the weather data: Swipe down to refresh the weather details.
  4. View detailed weather info: Access details like temperature, humidity, wind speed, etc.

🌐 API Integration

The app uses the OpenWeatherMap API to fetch live weather data. For more information on how the API works, visit OpenWeatherMap Documentation.

📝 License

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

💡 Contributing

Contributions are welcome! Follow these steps to contribute:

  1. Fork the repository.
  2. Create your feature branch:
     git checkout -b feature/YourFeature
  3. Commit your changes:
     git commit -m 'Add new feature'