TempoMail Mobile Client (iOS & Android) — Interactive Setup & Publishing Studio

1. Architecture & Commercial Workflow

Single Developer License

The TempoMail Mobile Client is engineered as an elite cross-platform native client (Flutter 3.x) that pairs directly with your TempoMail SaaS web platform. You maintain 100% ownership of all in-app subscription revenues and Google AdMob ad earnings.

Native Client Apps

Complete source code for iOS and Android with AdMob, In-App Purchases, and live IMAP mailbox sync.

SaaS Backend Bridge

Connects to your Laravel 11 SaaS via secure Bearer token REST API. No intermediate third-party servers required.

Dual Monetization

Google Play / Apple StoreKit in-app subscriptions ($4.99/mo) and programmatic high-CPM AdMob banner ads.

The Buyer Lifecycle Workflow:

Step 1: Use the Live Config Generator below to input your SaaS domain, API key, and AdMob IDs.
Step 2: Copy the generated configuration files into lib/core/config/.
Step 3: Generate your upload keystore with our Keystore Generator Tool.
Step 4: Compile the production release bundle with flutter build appbundle --release.
Step 5: Upload to your Google Play Console and Apple App Store developer accounts.
Step 6: Manage over-the-air content (domains, ads toggle, Pro prices) directly from your SaaS Admin Extension!

2. Interactive Live Config Generator

Real-Time Dart Code Builder

Enter your live SaaS domain and credentials below. The studio automatically generates production-ready Dart configuration files for your mobile project:

SaaS Backend API Base URL

Mobile API Secret Bearer Token

Application Display Name

Package Name / Bundle Identifier

Default Domain Extension

Brand Accent Color Hex

lib/core/config/app_config.dart

lib/core/config/admob_config.dart

lib/core/config/iap_config.dart

3. Android Keystore & Signature Command Builder

Production Signing

Google Play requires all release bundles to be signed with a secure 2048-bit RSA key. Generate your keystore command instantly:

Keystore File Name

Key Alias

Organization Name (CN)

Country Code (2 Letters)

Run this command in your project terminal:

Terminal Command

Save as android/key.properties:

android/key.properties

4. Complete Google Play Console Publishing Guide

8-Phase Manual

1

Account Registration & Merchant Payments Setup

Create an account at play.google.com/console ($25 one-time developer fee). Go to Developer account → Payment settings to link your corporate bank account. Google deposits 85% of subscription revenue directly to your bank account monthly under the 15% tier.

2

Create App Listing & Visual Assets

In Play Console, click Create app. Required assets:

App Icon: 512 × 512 px PNG (32-bit color with alpha)
Feature Graphic: 1024 × 500 px JPEG/PNG
Screenshots: Minimum 4 phone screenshots (1080 × 1920 or 1080 × 2400)
Privacy Policy URL: Link to your SaaS policy: https://yourdomain.com/privacy-policy

3

Configure In-App Subscriptions in Play Console

Go to Monetize → Products → Subscriptions → Create subscription:

Product ID: tempomail_pro_monthly
Name: TempoMail Pro VIP Monthly
Base Plan: Auto-renewing, 1 month, price $4.99
Grace Period: Set to 16 days (protects revenue from renewal card retry delays)

4

Google Cloud Service Account for Server-Side Verification

Open Google Cloud Console → Enable Google Play Android Developer API → Create Service Account → Export JSON Private Key. In Play Console → API Access, grant permissions: View financial data and Manage orders and subscriptions. Paste the JSON key into your SaaS Admin Extension!

5

Real-Time Developer Notifications (RTDN via Cloud Pub/Sub)

Set up a Pub/Sub topic projects/YOUR_PROJECT/topics/play-billing-notifications and add a push subscription pointing to https://yourdomain.com/api/v1/iap/google-play-webhook. When users cancel or renew, your database automatically syncs.

6

Sandbox License Testing ($0 Test Purchases)

In Play Console → Setup → License Testing, add your Gmail developer accounts. Set response to RESPOND_NORMALLY. Now test purchases on physical devices are completely free ($0 charged)!

7

Compiling & Uploading the Release Bundle (.aab)

In terminal, run:

                                    flutter clean && flutter pub get

                                    flutter build appbundle --release

Upload build/app/outputs/bundle/release/app-release.aab to Internal Testing, test with your team, and click Promote to Production!

5. Apple App Store Connect & TestFlight Guide

iOS HIG Standard

1

Apple Developer Program & Agreements

Enroll at developer.apple.com ($99/year). In App Store Connect → Agreements, Tax, and Banking, sign the Paid Applications Agreement and enter your bank details to receive subscriber deposits.

2

StoreKit In-App Subscriptions Setup

Create an Auto-Renewable Subscription Group with Product ID com.tempomail.subscription.monthly ($4.99). Generate an App Store Shared Secret and paste it into Tab 3 of your SaaS Admin Extension.

3

Compiling iOS Production Archive (.ipa)

In your macOS terminal, run:

                                    flutter build ipa --release
                                

Upload via Xcode Organizer or the Apple Transporter app directly to TestFlight, and submit for App Store Review.

6. Google AdMob Monetization Architecture

High CPM Engine

The app features a dual-layer monetization strategy: programmatic AdMob banners + high-value Pro in-app subscriptions.

Android Banner Ad Unit ID

Android Interstitial Unit ID

iOS Banner Ad Unit ID

iOS Interstitial Unit ID

Automated Ad Elimination for Pro Users: When a user logs in with an active Pro SaaS subscription or purchases via Google Play, all AdMob ads are automatically suppressed in real time!

7. Live SaaS REST API Health Tester

Browser Sandbox

Verify that your SaaS domain's mobile API is active, responding with valid JSON, and accepting client requests:

HTTP 200 OK Latency: 42ms

8. SaaS Admin Extension Module & Over-The-Air (OTA) Updates

Zero-Recompile Controls

The Mobile App Extension adds a dedicated control center inside your Laravel SaaS Admin Panel (/admin/plugins/mobile_app or /admin/extensions/mobile-app).

How Over-The-Air (OTA) Content Works:

When you add new domain extensions, change Pro subscription prices, or update your Zero-Log Privacy Policy in your SaaS admin panel, the mobile app fetches the new data on next launch via API. You never have to recompile or resubmit the mobile app for content updates!

Website Footer Download Badges:

Toggle the footer badges in your SaaS admin panel to automatically display official "Download on the App Store" and "Get it on Google Play" store buttons in your web platform footer.

9. Troubleshooting & FAQ

Q: Do I need a Mac to publish to Google Play?

No! Google Play release bundles (.aab) can be compiled on any Windows, Linux, or Mac PC. You only need a Mac or cloud CI (like GitHub Actions or Codemagic) when archiving for Apple iOS.

Q: Who receives the subscription and AdMob money?

You do! 100% of the funds go directly into your Google Payments Merchant Profile and your Google AdMob account. TempoMail takes 0% cut.

Q: How do custom domains work on mobile?

When a user logs in with their account or upgrades to Pro VIP via Google Play, the app retrieves all custom domains attached to their account in your SaaS database, allowing them to create addresses with their personal domains.