SoulMatch - SwiftUI Matrimony App Template

SoulMatch is a complete, ready-to-customize iOS matrimonial and matchmaking app template built with SwiftUI. It includes 25+ polished screens covering the full journey of a modern matrimony app: onboarding, profile creation, match discovery, interests, chat, voice/video calls, premium plans and account settings.

The project follows a clean MVVM structure (Models / ViewModels / Views) with a central theme file, so it is easy to rebrand, extend and connect to your own backend. Built-in sample data lets you explore every screen without configuring a server.

Full documentation included: installation, project structure, step-by-step reskin guide (app name, bundle ID, app icon, launch & splash screen, colours, fonts, texts), backend integration (REST API client, OTP login, Firebase, chat/call SDKs, push notifications, StoreKit 2 subscriptions) and a complete guide to building a signed release and publishing to the App Store.

Screens included:

• Onboarding: Splash, Onboarding, Login (phone + OTP, Google/Apple/Email buttons), Create Profile
• Main tabs: Matches (Home), Discover (swipe cards), Interests (received/sent), Messages, My Profile
• Profiles & communication: Profile Detail, Chat, Voice Call, Video Call, Contact Details (premium unlock), Kundli Match
• Search & filters: Search, Advanced Filters, Partner Preferences, Shortlist
• Engagement & account: Notifications, Who Viewed Me, Edit Profile, Premium Plans, Success Stories, Help & Support

Highlights:

• Swipe Discover cards with like, skip, super-like, boost and undo
• Kundli / horoscope compatibility screen
• Audio and video call UI with mute, speaker, camera switch and picture-in-picture preview
• Silver / Gold premium paywall and locked contact details flow
• Who Viewed Me stats, notifications center, shortlist with empty state
• Help & Support with FAQ accordion

Try the clickable live demo using the Demo link.

Features

• Smart matchmaking based on partner preferences
• Advanced search by age, height, religion, community, marital status and location
• Interest management: send, accept, decline and shortlist
• Private chat UI
• Voice and video call screens (ready for SDK integration)
• Kundli / horoscope matching section
• Notifications for new matches, interests and messages
• Premium membership plans and paywall
• Profile analytics (Who Viewed Me)
• Success Stories, Help & Support FAQ
• Clean MVVM architecture, modular Views / Models / ViewModels
• Central theme colors for quick rebranding
• Sample data - runs without a backend
• Detailed English documentation: installation, reskin, backend integration and App Store publishing

Requirements

• Mac with Xcode 16 or later
• iOS 16.0 or later
• Swift 5.9+ / SwiftUI
• No third-party dependencies
• Your own backend/API for production use (sample data works without one)
• Apple Developer Program account for release builds

Instructions

1. Unzip the main file and open Documentation/SoulMatch_Documentation.html in a browser for the full guide.
2. Open SoulMatch.xcodeproj in Xcode, select the SoulMatch target and set your Team and Bundle Identifier.
3. Run on a simulator or device - the app starts with built-in sample data.
4. Reskin: change the Display Name, replace AppIcon.png, edit colours in Theme.swift and the splash in SplashView.swift (guide section 6).
5. Connect your backend using the included API client / Firebase instructions (guide section 8).
6. Archive and upload to App Store Connect following guide section 9.