Before you start
Create a free account at clickproof.app. What you need next depends on what you are testing.- Website
- Mobile app
A URL the browser can reach: production, staging, or a preview deployment.
Nothing to install and nothing to upload.
1
Create a website project
In the dashboard, create a project, choose Website, and give it the
URL to test. That URL is where every run starts.
2
Describe a test
Write what it should do in plain English, for example:
Open the pricing page, start the Pro checkout, and pay with the test card. It passes when an order confirmation is visible.clickproof turns this into a plan automatically. You land on the project’s Tests tab straight after creating it, because a website project has everything it needs already.
3
Run the test
Hit Run. The agent drives a real hosted Chromium browser, and you can
watch it live while it works. Within a couple of minutes you get a
verdict + video report.
The site has to be reachable from the public internet. A URL behind a VPN,
an IP allowlist, or
localhost will not load. Deploy a preview and point
the test at that.Then wire it into CI
Once a project has tests, connect it to your repository so every pull request is tested automatically. This is the same for both surfaces, and it is where clickproof earns its keep: a test nobody runs catches nothing.1
Install the GitHub App
Open your project’s PR Testing tab, choose Install GitHub App, and
pick the repositories it should see. Once per organization.
2
Connect the repository to your project
Back on PR Testing, pick the repository.A website project needs nothing else: clickproof waits for your host to
report a successful preview deployment and tests that.A mobile project needs to know which artifact is which. Press Detect
from recent builds and clickproof reads what your workflows actually
upload, then gives you a checkbox per platform it found.
3
Open a pull request
clickproof runs the project’s tests and posts a check run plus a comment
linking each report. A failing test fails the check.
Find your project id in the dashboard URL:
clickproof.app/projects/<id>.