Integration

Mobile App Testing in GitHub Actions

Point a workflow step at your build and VibeView runs your test spec on a live iOS simulator or Android emulator, then reports the result back to the pull request. Steps are written in plain English and interpreted by the AI agent (beta) — no scripted selectors, no Mac runner, no local simulator install.

Start free Read the docs

How it works

1. Add your API token as a repository secret

Create a token in VibeView under Settings > API Tokens, then add it to your repository as the VIBEVIEW_API_TOKEN secret so the workflow can authenticate.
2. Add the workflow template

Copy the VibeView workflow template into .github/workflows/vibeview-test.yml, point it at your build output, and describe your test as plain-English steps in .vibeview/test-spec.json. The AI agent (beta) interprets each step against the running app.
```
- name: Run VibeView suite
  env:
    VIBEVIEW_API_TOKEN: ${{ secrets.VIBEVIEW_API_TOKEN }}
  run: |
    vibeview run-suite ${{ secrets.SUITE_ID }} \
      --commit-sha ${{ github.sha }} \
      --output junit > results.xml
```
3. Read the results on the pull request

The workflow posts a comment on the pull request with the overall pass or fail status, a table of per-step results, and a link through to the full run in VibeView.

Full setup instructions live in the documentation.