Avatario — AI Avatar Generator (iOS)

Product Overview

Avatario is a fully-functional, production-ready iOS application designed for AI-powered avatar and headshot generation. Users upload a selfie or reference photo, select a portrait style, and the application generates high-quality transformed images. The project is fully integrated with Firebase for backend operations, RevenueCat for subscription billing, and uses a secure Cloud Functions setup to interface with AI endpoints.

Technical Stack

• Frontend: Swift & SwiftUI (iOS 18.4+)
• Backend: Node.js (v22+) & Firebase Cloud Functions v2
• Database & Storage: Firebase Storage (for images) & Firestore
• Authentication: Firebase Authentication
• Monetization: RevenueCat SDK
• Image Caching & Loading: Kingfisher

Libraries & Dependencies (Swift Package Manager)

• firebase-ios-sdk (Firebase Authentication, Storage, Functions)
• purchases-ios-spm (RevenueCat subscription management)
• Kingfisher (High-performance image downloader and cache)
• Glur (Smooth gradient blur styling for image backgrounds)
• GoogleSignIn-iOS (Google OAuth Sign-In integration)
• SystemNotification (Native in-app notifications)
• SwiftyJSON (Robust JSON parsing)
• iOS-Backports (Backwards compatibility features)

Avatario — App Features & Functionalities

Core App Features

1. AI Avatar & Headshot Generation

• Selfie Uploads: Users can select or snap a reference selfie directly in the app.
• Custom Style Selection: Interactive catalog where users browse and select various target avatar styles.
• Async AI Image Processing: Cloud-based image generation workflows powered by fal.ai and OpenAI.

2. Rich User Interface & Navigation

• Onboarding Scroll Grid: Dynamic, smooth scrolling grid of onboarding sample images to instantly engage users.
• Dynamic Catalog Home Screen: Loads image styles dynamically from a configuration JSON (image_prompts_with_source.json), permitting easy style catalog updates on the fly.
• Custom Blur & Transition Effects: Implements modern design patterns utilizing Glur and backdrop blurs.

3. Monetization & Paywalls

• RevenueCat Subscriptions: Full integration with RevenueCat, locking style generation behind a pro entitlement.
• Seamless Checkout: In-app purchases for subscriptions or lifetime unlocks.

4. Authentication & User Profile

• Apple Sign-In: Native one-tap Apple authentication.
• Google Sign-In: Firebase-backed Google OAuth credentials flow.
• Profile Customization: Local/cloud profile settings with customizable options and support ticket forms.

5. Advanced Backend Security

• Firebase Cloud Functions Proxy: AI API keys are stored securely as Firebase Secrets, meaning they are never exposed in the iOS binary.
• Firebase App Check Enforcement: Validates that all incoming API calls originate from legitimate app binaries, preventing API abuse and scraper bots.