Preview and Debug MiniApps

This guide describes the methods for debugging miniapps during development.

There are four ways to Preview and Test your MiniApp:

  • In Visual Studio Code (docs)
    Limitation: does not support certain SDKs (e.g., motion).
  • In Android Simulator (docs)
    Limitation: does not support GoPay JSAPIs (getAuthCode, launchDeeplink, launchUri, and launchPayment)
  • In IOS Simulator (docs)
    Limitation: does not support GoPay JSAPIs (getAuthCode, launchDeeplink, launchUri, and launchPayment)
  • In GoPay (docs)
    No limitation, you need to publish and release miniapp first. This will not appear in GoPay page until it's officially release so you may safely test this.

Note: If you see errors while testing in a browser, it’s because the APIs are only supported within the GoPay app and are not available in browsers.


Visual Studio Code

  1. Open VS Code and Render application.

  2. Click Preview Miniapp in the plugin sidebar.

    • Yes: Manually input your MiniApp preview URL.
    • No: The plugin will run your start script and show the preview input afterward.
  3. Paste your MiniApp URL in the top input field..

  4. The preview will appear inside VS Code..

  5. To debug, run Developer: Toggle Developer Tools from the command palette..


Android Simulator

  1. Click Preview Miniapp in Android Emulator..

  2. Enter the preview URL in the field that appears..

  3. Open Chrome → go to chrome://inspect/#devices → find the WebView and click Inspect..


IOS Simulator

  1. In Safari: Enable Develop menu in Preferences > Advanced.

  2. Click Preview Miniapp in iOS Emulator, then select a simulator.


  3. Enter the MiniApp preview URL.

  4. In Safari: Go to Develop > Simulator, then click the WebView to inspect it.

  5. Click the WebView object that you want to inspect, and then debug the miniapp in Web Inspector.