StagedAI - Professional Virtual Staging App

Transform empty rooms into stunning staged spaces instantly

---

📱 Overview

StagedAI is a professional-grade virtual staging app designed for real estate agents and Airbnb hosts. Using cutting-edge AI technology, it transforms empty or poorly furnished rooms into beautifully staged spaces in seconds.

Key Features

• 🪄 AI-Powered Staging - Powered by Gemini Vision and Image Generation
• 🎨 8+ Design Styles - From Scandi Clean to Modern Luxury
• 📊 Intensity Control - Fine-tune transformations from subtle to complete
• 📹 Viral Export - Generate stunning before/after reveal videos
• 💾 Local-First - All data stored securely on device with SwiftData
• 💳 Premium Subscription - RevenueCat integration with 3-day free trial

---

🏗️ Architecture

Tech Stack

Component	Technology
Frontend	Swift, SwiftUI
Architecture	MVVM
Local Persistence	SwiftData
Configuration	Firebase Remote Config
AI Vision	Gemini Flash Latest
AI Generation	Gemini 2.5 Flash Image
Payments	RevenueCat
Video Export	AVFoundation

Project Structure

StagedAI/
├── StagedAIApp.swift           # App entry point
├── ContentView.swift           # Main navigation
├── Models/
│   ├── Listing.swift           # SwiftData model
│   ├── TransformationStyle.swift
│   └── VisionAnalysis.swift
├── Services/
│   ├── GeminiService.swift     # AI integration
│   ├── RemoteConfigManager.swift
│   └── VideoGenerator.swift    # Viral export
├── ViewModels/
│   ├── HomeViewModel.swift
│   ├── UploadViewModel.swift
│   └── ResultViewModel.swift
├── Views/
│   ├── PaywallView.swift
│   ├── HomeView.swift
│   ├── UploadView.swift
│   ├── ResultView.swift
│   └── SettingsView.swift
├── Utilities/
│   └── Extensions.swift
└── Assets.xcassets/

---

🚀 Getting Started

Prerequisites

• Xcode 15.0+
• iOS 17.0+ device or simulator
• Gemini API Key (get one at ai.google.dev)

Setup

1. Clone the repository

   git clone https://github.com/yourusername/StagedAI.git
   cd StagedAI

2. Open in Xcode

   open StagedAI.xcodeproj

3. Configure API Key

   Recommended: Edit Config.swift

   Open StagedAI/Config.swift and set your Gemini API key:

   static let geminiAPIKey: String? = "YOUR_ACTUAL_API_KEY_HERE"

   Replace nil with your actual API key string (e.g., "AIzaSy..."). Get your API key at ai.google.dev.

   Alternative: Via Xcode Build Settings

   If you prefer not to hardcode the key:

   1. Select your project in the Project Navigator
   2. Select the StagedAI target
   3. Go to the Build Settings tab
   4. Click the + button → Add User-Defined Setting
   5. Add:
      • Name: GEMINI_API_KEY
      • Value: Your actual Gemini API key
   6. The key will be substituted into Info.plist at build time

4. Build and Run

   Select your target device and press ⌘R

Firebase Setup (Optional)

To enable Remote Config for dynamic style updates:

1. Create a Firebase project at console.firebase.google.com
2. Add an iOS app with your bundle identifier
3. Download GoogleService-Info.plist and add to the project
4. Add the Firebase SDK via Swift Package Manager
5. Create a Remote Config parameter staging_styles with your style JSON

---

🎨 The Staging Agent Pipeline

How It Works

1. Vision Analysis (gemini-flash-latest)

   • Analyzes room type, architectural features, and lighting
   • Outputs structured JSON for prompt construction

2. Intensity Slider Logic

   • Low (0-30%): Refresh lighting and colors only
   • Medium (30-70%): Replace furniture, keep architecture
   • High (70-100%): Complete room restaging

3. Image Generation (Gemini 2.5 Flash Image)

   • Constructs detailed prompt from analysis + style + intensity
   • Generates photorealistic 8K staged image

Example Prompt

Professional architectural photography of a Living Room. 
Keep the architectural shell (walls, floor, windows) exactly as is. 
Replace the current furniture with Scandi Clean furniture in the same arrangement. 
Feature exposed brick, hardwood floors, floor-to-ceiling windows. 
minimalist, white oak wood, neutral beige textiles, airy atmosphere. 
Lighting: Natural light from left side windows. 
8k resolution, wide angle, photorealistic, no artifacts.

---

📱 Screens

1. Paywall View

• Animated gradient background with floating orbs
• Feature highlights with checkmarks
• Monthly/Yearly plan selection
• 3-day free trial CTA

2. Home View

• Category icons (Interior, Garden, Kitchen, etc.)
• Recommendation cards with gradient backgrounds
• "Try It!" pill buttons

3. Upload View

• Dashed-border upload card
• Camera and Gallery buttons
• "My Photos" carousel from SwiftData

4. Result View

• Before/After slider with wipe effect
• Intensity slider (0-100%)
• Style and Color Palette selectors
• Regenerate button
• Save/Share action bar

---

📹 Viral Export

The Share Reel feature generates a 4-second video with:

• Resolution: 1080x1920 (9:16 for Stories/Reels)
• Effect: Smooth wiper reveal from before → after
• Animation: Eased cubic timing
• Watermark: "StagedAI" branding

// Generate share video
let videoURL = try await videoGenerator.generateWiperVideo(
    beforeImage: before,
    afterImage: after
) { progress in
    print("Progress: \(progress * 100)%")
}

---

💳 Monetization

RevenueCat Integration

// In production, integrate with RevenueCat:
Purchases.shared.purchase(package: selectedPackage) { transaction, info, error, cancelled in
    if let error = error {
        // Handle error
    } else if !cancelled {
        // Grant premium access
    }
}

Pricing

• Free Trial: 3 days full access
• Monthly: $9.99/month
• Yearly: $79.99/year (Save 33%)

---

🔧 Configuration

Remote Config Schema

{
  "staging_styles": [
    {
      "id": "scandi",
      "name": "Scandi Clean",
      "icon": "sofa",
      "prompt_modifier": "minimalist, white oak wood, neutral beige textiles, airy atmosphere"
    }
  ]
}

---

📄 License

This project is proprietary software. All rights reserved.

---

👥 Team

Built with ✨ for real estate professionals.

---

📞 Support

• Email: [email protected]
• Website: https://stagedai.app