Pairly | Couples Quiz and Relationship App With Pairing, Journal, Widgets and Paywalls - SwiftUI

Pairly is a full-featured couples connection app built with SwiftUI and a Convex real-time backend. Two partners pair with an 8-digit code and unlock shared daily quizzes, a memory journal, live drawing games, an AI-powered argument analyzer, photo maps, and home screen widgets. The template ships with the complete iOS source code, the Convex backend functions, and a Next.js admin dashboard.Demo Instructions Pairly requires backend configuration before it runs – this is a full-stack template, not an offline app. Please read this section before testing:No login or demo credentials are required. The app uses anonymous Firebase authentication – a user profile is created automatically on first launch. Out of the box the app connects to a demo Convex backend so you can see the onboarding flow and pairing screen immediately. For a fully working setup (quizzes, journal, discussions, widgets) you connect your own free Convex and Firebase accounts – step-by-step instructions with screenshots are in the included documentation.html, section “Backend Configuration (Convex + Firebase)”. Configuration is about 15 minutes and does not require writing any code.Two free accounts are needed: a Convex account (backend) and a Firebase project (anonymous sign-in). Additionally, the AI features (Argument Analyzer, AI chat/transcription) require a paid OpenRouter account (openrouter.ai, usage-based credits – a few dollars is plenty for testing; see “Third-Party Service Costs” below).Everything the App DoesInteractive onboarding flow (12+ pages) with Lottie animations, name input, anniversary date, relationship goals, profile photo, daily time commitment and confetti completion Pairly Anonymous authentication – no signup screens, users just start using the app Secure partner pairing with 8-digit codes, shareable deep links (pairly://invite/12345678) and real-time pairing status Solo mode – the app is fully browsable before pairing, with pairing prompts 2,500+ quiz questions across multiple categories (After Dark, Daily Life, Family and Friends, Future Dreams, Personal Growth, Social Situations and more) Hand-picked daily quizzes with real-time two-player sessions and partner waiting statesQuiz types: multiple choice, This or That, You or Me, Never Have I Ever, image upload questions and a live drawing game Quiz results with compatibility comparison and gauges Quiz discussions – chat about any quiz result with your partner AI Argument Analyzer – record an argument, Gemini AI analyzes communication patterns, radar charts, emotion tracking over time, category scores, analysis history Live Drawing game – both partners draw together in real time on a shared canvas Memory journal – photo memories with location tagging, special days, anniversary trackingPhoto Map – memories pinned on an interactive MapKit map with reverse geocoding Memory and journal discussions with your partner Pairly Home dashboard with journey progression, today’s quizzes, quick actions and subscription CTA banners 4 home screen widget types: shared canvas drawing, time together counter, countdown to special dates, and partner distance widget (several visual styles including dino, hands, tin can and couple themes)Push notifications via Firebase Cloud Messaging with a Notification Service Extension for rich communication notifications Pairly Local notifications for anniversary and special date reminders Pairly Superwall paywalls with RevenueCat subscription management – optional subscription gating code, ready for App Store monetization Light and dark theme support (dark optimized)Core Haptics feedback, Lottie animations, confetti celebrations and designed empty states throughout Real-time sync engine (Convex subscriptions) with offline caching Next.js admin dashboard for user, couple and quiz management with analyticsTechnologyiOS app: SwiftUI + MVVM, Combine, iOS 17.0+, Xcode project with CocoaPods (SuperwallKit) and Swift Package Manager (Convex, Firebase, Lottie, RevenueCat, Sentry, and more)Backend: Convex (TypeScript-style JavaScript functions, real-time sync engine, scheduled cron jobs)Authentication: Firebase Anonymous Auth with token validation middleware on the backendPayments: Superwall paywalls + RevenueCat subscriptionsAI: Argument analysis via OpenRouter (Gemini Flash model, bring-your-own API key)Admin: Next.js 15, React 19, Tailwind CSS, shadcn/ui