SnapReels Flutter App Setup (Android & iOS)

Before building the app, make sure you have installed the necessary developer tools:

• Flutter SDK: Version 3.24.0 or newer (Stable channel).
• IDE: Visual Studio Code (with Flutter extension) or Android Studio.
• For Android: Android Studio, Android SDK (API 34+), and Java JDK 17+.
• For iOS: macOS computer with Xcode 15+ and CocoaPods installed.

Open the flutter_app folder in your code editor and navigate to:

lib/config/app_config.dart

Update the configuration with your website domain and API Key:

class AppConfig {
  // Replace with your production website URL (without trailing slash)
  static const String baseUrl = "https://yourdomain.com";

  // Replace with the API Key configured in Admin Panel -> Settings -> Mobile Settings
  static const String apiKey = "YOUR_SECURE_API_KEY";

  static String get apiUrl => "$baseUrl/api/mobile/v1";
}

SnapReels utilizes Firebase for user authentication (Email/Password, Google Sign-In, Apple Sign-In) and Push Notifications.

Go to the Firebase Console and create or select your project:

A. Android Setup:

1. Add an Android App in Firebase Console with your package name (e.g. com.yourbrand.snapreels).
2. Add your SHA-1 Fingerprint (required for Google Sign-In).
3. Download google-services.json and place it inside: flutter_app/android/app/google-services.json.

B. iOS Setup:

1. Add an iOS App in Firebase Console with your iOS Bundle Identifier.
2. Download GoogleService-Info.plist and place it inside: flutter_app/ios/Runner/GoogleService-Info.plist.
3. Open flutter_app/ios/Runner/Info.plist and make sure your REVERSED_CLIENT_ID (found inside GoogleService-Info.plist) is added under CFBundleURLSchemes:

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <!-- Paste your REVERSED_CLIENT_ID from GoogleService-Info.plist -->
            <string>com.googleusercontent.apps.YOUR-REVERSED-CLIENT-ID</string>
        </array>
    </dict>
</array>

1. Change App Name:

Android: Open android/app/src/main/AndroidManifest.xml and update android:label="Your App Name".

iOS: Open ios/Runner/Info.plist and update CFBundleDisplayName.

2. Change Package Name / Bundle ID:

Android: Update applicationId in android/app/build.gradle.

iOS: Open the project in Xcode, click on Runner, and update Bundle Identifier under General / Signing & Capabilities.

3. App Icons & Splash Screen:

Replace the icon images inside:

• android/app/src/main/res/mipmap-*/
• ios/Runner/Assets.xcassets/AppIcon.appiconset/

Or use the flutter_launcher_icons package to automatically generate all icons from a single 1024x1024 PNG image.

SnapReels includes seamless native In-App Purchases for buying coins and VIP passes:

• Google Play Billing (Android): Users pay via Google Play in 1-tap.
• Apple In-App Purchase (iOS): Users pay via Apple ID / FaceID / TouchID in 1-tap.

Matching Product IDs:

Ensure that the Coin Pack IDs you create in your Admin Panel -> Monetization -> Coin Packs exactly match the Product IDs in Google Play Console (In-app products) and Apple App Store Connect (In-App Purchases -> Consumable).

A. Build for Android (Google Play Store):

flutter build appbundle --release

The generated .aab file will be at: build/app/outputs/bundle/release/app-release.aab.

To generate an APK for direct testing:

flutter build apk --release

B. Build for iOS (Apple App Store):

flutter build ipa --release

Or open ios/Runner.xcworkspace in Xcode, select Product -> Archive, and use the Organizer to upload your build directly to App Store Connect / TestFlight.