Before you start
Create a free account at clickproof.app and have an app build ready: an.apk for Android, or a simulator .app.zip for iOS.
From the dashboard
1
Create a project
In the dashboard, create a project and pick its platform (Android or iOS).
A project groups one app’s builds and tests.
2
Describe a test
Add a test and write what it should do in plain English, for example:
Open the app, complete the sign-up flow, and reach the home screen. It passes when the main home screen is visible.clickproof turns this into a plan automatically.
3
Upload a build
On the project’s Mobile tab, upload your
.apk or .app.zip. One project
can hold both.4
Run the test
Hit Run. The agent drives a real cloud device, and within a couple of
minutes you get a verdict + video report.
From CI (recommended)
Once a project has tests, wire clickproof into your pipeline so every pull request is tested automatically.1
Create an API key
In the dashboard, go to Integrations → GitHub and create an API key.
Add it to your repository as a secret named
CLICKPROOF_API_KEY
(Settings → Secrets and variables → Actions).2
Add the workflow
Commit this as
.github/workflows/clickproof.yml:3
Open a pull request
The Action uploads the build, runs the project’s tests, and posts a results
table to the job summary — failing the check if any test fails.
Find your project id in the dashboard URL:
clickproof.app/projects/<id>.