Skip to main content
Mini tests a web app in the browser, at a URL you give it or on a build of your repository it serves itself. This page covers which address a run opens, the browsers and screen sizes you can pick, and how to change both for a single run.

​
Where a run points

Open the app and go to App settings → General → Web configuration.
  • Web app URL is the address Mini opens on every run: production, staging, or any host Mini can reach.
  • With a repository linked to the app, you can leave the URL empty. Mini then builds your frontend at the commit it tests and serves it on a preview host. A run on a commit always tests that commit’s build, even when the app also has a URL.
To test another address once, without changing the app, set the URL for that run. In Run tests, the web card has a Web URL for this run field. In CI, pass web-url to the GitHub Action:
A per-run URL is ignored when the run tests a commit’s build. The CLI and Slack run the app’s configured URL. See the GitHub Action reference for every web input.

​
Preview hosts for repository builds

When Mini builds a commit of your web app, it serves the build on a generated host:
<workspace_slug> is your workspace slug, shown in Settings → General. <preview_key> changes with every build, so each build gets its own host. The build receives MINITAP_PREVIEW_URL, set to that host. You don’t add the variable yourself. Where your build config needs the address, write {{MINITAP_PREVIEW_URL}} and Mini fills it in at build time:
If your app uses OAuth or any list of allowed origins, add this wildcard to your provider once, so every preview build signs in without a change per build:

​
Browsers and screen sizes

In App settings → General → Web configuration, What devices do your users use to visit your website? sets the app’s default targets. Pick one or more: Mini runs the scenarios on each target you pick. Desktop and tablet keep a fixed viewport for the whole run. Safari is available on iPhone only.

​
Pick targets for one run

​
Camera feed for web scenarios

When a scenario scans a QR code or takes a photo with the webcam, give it the image or video the camera should show. Open the scenario and set its Camera property; without one, the scenario uses the Default feed. The file loops as the camera on desktop and tablet targets. Chrome on Android and Safari on iPhone ignore it. From the CLI, pass a local file or the ID of a file you already uploaded:
Videos can be up to 50 MB and images up to 25 MB.

​
Next steps

Reach private apps

Staging behind a firewall, a VPN or a country restriction.

Test accounts and sign-in

The users Mini signs in as on your site.

Pull request checks

A verdict on every PR, against its preview or its commit.

What Mini can do on the web

Cookies, offline mode, the browser speaker and more.