Shaadify-iOS 💍

📱 Shaadify iOS – An open-source matrimony app built with love 💖 in Swift & SwiftUI, powered by MVVM and Combine.

Crafted by the community, for the community ❤️, Shaadify showcases clean architecture, modular design, and modern Apple frameworks 🚀 – making it both a learning project and a real-world matrimony platform.

---

✨ Features

• SwiftUI-based UI with clean MVVM architecture
• Reactive data binding using Combine
• Modular, scalable design for community contributions
• Modern iOS best practices (SPM, Swift Concurrency, testing)
• A real-world use case: matrimony & matchmaking app

---

🛠 Tech Stack

• Language: Swift
• UI Framework: SwiftUI
• Architecture: MVVM
• Reactive Layer: Combine
• Dependency Management: Swift Package Manager
• Testing: XCTest (with potential integration of Quick/Nimble)

---

📂 Project Structure

Shaadify-iOS
├── ShaadifyApp/           # Main iOS app target
│   ├── Models/            # Data models
│   ├── Views/             # SwiftUI views
│   ├── ViewModels/        # MVVM view models
│   ├── Services/          # Networking, storage, APIs
│   └── Resources/         # Assets, strings, configs
├── ShaadifyTests/         # Unit & UI tests
└── README.md

---

🚀 Getting Started

🔹 Xcode Version

• Latest stable (Aug 2025): Xcode 15.x (ships with Swift 5.9/5.10).
• Supports iOS 17/18 SDKs, modern SwiftUI, and Swift Concurrency.
• Apple generally drops support for very old macOS in each major Xcode release.

👉 Recommendation:

• Minimum Xcode: 15.0 (first release with Swift 5.9, async/await stable, SwiftUI improvements).
• Recommended Xcode: Latest stable (15.x or newer) → ensures compatibility with iOS 18 SDK.

---

🔹 macOS Version

• Xcode requires fairly recent macOS versions.
• Xcode 15.x requires macOS Ventura (13.0) or later.
• macOS Sonoma (14) and Sequoia (15) are already common in 2025.

👉 Recommendation:

• Minimum macOS: 13.0 (Ventura)
• Recommended macOS: 14.0 (Sonoma) or 15.0 (Sequoia) → better stability and long-term support.

Prerequisites

• macOS (latest recommended)
• Xcode 15+
• Swift 5.9+

Installation

1. Clone the repository

   git clone https://github.com/iOS-Labs/Shaadify-iOS.git
   cd Shaadify-iOS

2. Open in Xcode

   open Shaadify.xcodeproj

3. Build & run on Simulator or your iPhone 🎉

---

🤝 Contributing

We ❤️ contributions! Here’s how you can help:

1. Fork the repo
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit changes (git commit -m 'Add some amazing feature')
4. Push to branch (git push origin feature/amazing-feature)
5. Open a Pull Request

📌 Please read our upcoming CONTRIBUTING.md and CODE_OF_CONDUCT.md before contributing.

---

📸 Screenshots / Preview (Optional)

(Add later once UI is ready – mockups or actual app screenshots can go here)

---

📜 License

This project is licensed under the Apache License 2.0 License – see the LICENSE file for details.

---

🌍 Community

Shaadify is a proud initiative by the iOS Labs Community – a place where iOS developers learn, build, and grow together.

💬 Join us to collaborate, share ideas, and build impactful projects:
👉 [iOS Labs WhatsApp / Discord link here]

---

✨ Built with love by the community, for the community. 💖