📱 SUPLEX CITY — App Store Guide

How to publish your game on iOS, Android, and the Web

📱 Publishing Options

🌐 Method 1: Progressive Web App (PWA) EASIEST — READY NOW

Your game is already a PWA. Users can install it directly from their browser on any device — no app store needed. This is the fastest way to get "app-like" distribution.

  1. Deploy your game using the Replit "Publish" button — this gives you a .replit.app URL
  2. Android: Visit your game URL in Chrome → tap ⋮ menu → "Add to Home Screen" → installs as a standalone app
  3. iOS: Visit in Safari → tap Share button → "Add to Home Screen" → installs as a standalone app
  4. Desktop: Chrome/Edge shows an "Install" button in the address bar automatically
💡 Your manifest.json and service worker are already configured. Just deploy and share your URL!

🤖 Method 2: Google Play Store (PWA Builder) RECOMMENDED

Wrap your PWA in a Trusted Web Activity (TWA) and submit to Google Play — no native code required. Cost: $25 one-time Google Play developer fee.

  1. Deploy your game and get your .replit.app public URL
  2. Go to pwabuilder.com and enter your game URL
  3. PWA Builder will validate your manifest, service worker, and icons automatically
  4. Click "Package for Stores" → select Android → download the APK/AAB
  5. Create a Google Play Console account ($25 fee)
  6. Upload the AAB, fill in the store listing (title, description, screenshots), and submit for review
  7. Review takes 1–3 business days. Once approved, it's live on the Play Store!
App name: SUPLEX CITY Short description: Open-World Multiplayer Wrestling Sandbox Category: Games → Action Rating: Teen (violence, combat) Price: Free (with in-app purchases)
💡 Use screenshots from the game (1080×1920 for phone, 1920×1080 for tablet). PWA Builder can generate them automatically.

🍎 Method 3: Apple App Store (Capacitor) REQUIRES macOS + XCODE

Wrap your web game in a native iOS shell using Capacitor.js. Requires Apple Developer account ($99/year) and a Mac with Xcode.

  1. Install Capacitor on your local machine: npm install @capacitor/core @capacitor/cli @capacitor/ios
  2. Initialize Capacitor with your game's config (see capacitor.config.json in your project)
  3. Add iOS platform: npx cap add ios
  4. Build the web assets: npx cap sync
  5. Open in Xcode: npx cap open ios
  6. Sign with your Apple Developer certificate in Xcode → Product → Archive
  7. Upload to App Store Connect via Xcode Organizer
  8. Fill in store listing, screenshots, privacy labels, and submit for review
  9. Apple review takes 1–3 business days
⚠️ Apple requires: Privacy Nutrition Labels, App Privacy Policy URL (your /privacy.html), age rating (12+ for combat), and in-app purchase declarations if using Stripe.
// capacitor.config.json (already in your project) { "appId": "com.suplexcity.game", "appName": "SUPLEX CITY", "webDir": "public", "server": { "url": "https://YOUR-GAME-URL.replit.app/game/", "cleartext": false } }

🛒 Method 4: Amazon Appstore FREE SUBMISSION

Submit your PWA directly to Amazon's Appstore — free for developers. Works on Fire tablets and Android devices. No fee!

  1. Create a free Amazon Developer account
  2. Go to the Appstore Console → Add a New App
  3. Select "Web App" and enter your deployed game URL
  4. Fill in app details, screenshots, icon, and description
  5. Submit — review takes 1–5 business days

💰 Monetization Setup

💳 Stripe Payments (In-Game Shop)

Your in-game shop is built and ready. Connect Stripe to start collecting real payments.

  1. Open the Integrations panel in Replit (left sidebar) → find Stripe
  2. Connect your Stripe account (free to sign up at stripe.com)
  3. Your shop will automatically switch from demo mode to live payments
  4. Monitor sales in your Stripe Dashboard
💡 The shop already has 15+ items across colors, effects, titles, and battle passes ($0.99–$29.99). Stripe takes 2.9% + $0.30 per transaction.

📺 Google AdSense (Banner Ads)

Display ads on your landing page to earn passive revenue from visitors who aren't playing.

  1. Sign up at adsense.google.com with your Google account
  2. Add your game's URL and wait for approval (usually 1–3 weeks)
  3. Once approved, get your Publisher ID (looks like ca-pub-1234567890123456)
  4. Replace YOUR-ADSENSE-CLIENT-ID in your landing page (index.html) with your real ID
  5. Create ad units in AdSense and replace the data-ad-slot values
💡 Typical RPM (revenue per 1000 views) for games: $1–$5. At 10,000 monthly visitors, that's $10–$50/month from ads alone.

📱 Google AdMob (In-App Ads for Mobile)

When published as a native app (Capacitor), use AdMob for in-app banner and rewarded ads.

  1. Sign up at admob.google.com
  2. Install Capacitor AdMob plugin: npm install @capacitor-community/admob
  3. Create ad units (banner, interstitial, rewarded) in the AdMob console
  4. The rewarded ad button in your shop already has the UI — just wire it to AdMob's SDK

☕ Ko-fi / Patreon (Direct Support)

Accept voluntary donations from fans who love the game. Zero fees on Ko-fi, 5–12% on Patreon.

  1. Create a page at ko-fi.com or patreon.com
  2. Set up your creator page with the game's branding
  3. Replace the Ko-fi/Patreon links in the shop with your actual profile URLs
  4. Add exclusive Patreon perks: early access districts, exclusive cosmetics, name in credits

📊 Revenue Potential

$50–500
Monthly from ads at 10k–100k visitors
$500+
Monthly from shop if 100+ Battle Pass subscribers
∞
Growth scales with players — more players = more revenue