Skip to main content

Testing

Test on Desktop​

  1. Open the Simulator/Preview
  2. Click the browser pop-out button

DesktopPopout

Test on Mobile​

To test your project on mobile devices, especially for AR experiences that require camera access, you'll need to serve your development server over HTTPS. We recommend using ngrok to create a secure tunnel to your local server.

  1. Go to ngrok.com and create an account. Once signed in, follow the steps on the dashboard to install ngrok.
  2. Update (or verify) your project configuration. In the config folder, open webpack.config.js and look for the devServer object. Add (or verify) ngrok as an allowedHost:
devServer: {
  // ... existing config
  allowedHosts: ['.ngrok-free.dev']
}
  1. Relaunch the desktop app or exit/reopen the project to refresh the build after updating the webpack configuration
  2. Open the Simulator/Preview and click the browser pop-out button

DesktopPopout

  1. From the new browser window, copy the port number appended to the end of the localhost URL

SimulatorPort

  1. Open a terminal window and run the following command, replacing [port] with the port obtained from the simulator browser pop-out
ngrok http [port]

In the output you should see an ngrok URL that uses HTTPS and forwards to your local development server. You can paste this into your browser window and test your project on a mobile device.