GemShell

Appearance

Mobile Builds ​

GemShell wraps your HTML5 game into a native iOS and Android app using Capacitor — the same technology behind apps like Burger King and Popeyes. Your game runs inside a native WebView with full device access.

How It Works ​

Your HTML5 Game
     ↓
GemShell packages it into a Capacitor project
     ↓
iOS: Xcode project  →  App Store
Android: Android Studio project  →  Google Play

GemShell handles the scaffolding. You sign and publish from the native IDEs.

Requirements ​

iOS ​

No Mac? Use Ionic Appflow

Ionic Appflow lets you build iOS apps in the cloud — no macOS required. Connect your generated Capacitor project and trigger cloud builds from any OS.

Android ​

  • macOS, Windows, or Linux
  • Android Studio with Android SDK
  • ANDROID_HOME environment variable set
  • Java 17+ (bundled with Android Studio)
  • Node.js 18+

Target Platforms ​

In GemShell, go to Target Platforms and enable iOS and/or Android under the Mobile section.

Build ​

Click Build — GemShell will:

  1. Copy your game files into a www/ folder
  2. Generate a package.json with Capacitor dependencies
  3. Run npm install to install Capacitor
  4. Add the iOS/Android platform (cap add ios / cap add android)
  5. Sync your game files (cap sync)
  6. Patch orientation (landscape/portrait based on your window size)
  7. Generate app icons from your project icon

When the build finishes, click "Open in Xcode" or "Open in Android Studio" from the Deploy tab to complete signing and publishing.

Project Settings ​

These settings affect your mobile build:

SettingEffect
App NameDisplay name on the home screen
Bundle IDReverse-domain ID (e.g. com.yourname.mygame)
VersionApp version shown in the stores
IconApp icon — auto-resized for all required sizes
Window Width/HeightDetermines orientation (width > height = landscape)

Next Steps ​