{"id":21585434,"url":"https://github.com/testdriverai/testdriver-web","last_synced_at":"2026-02-25T03:32:10.024Z","repository":{"id":226678964,"uuid":"765733507","full_name":"testdriverai/testdriver-web","owner":"testdriverai","description":null,"archived":false,"fork":false,"pushed_at":"2025-01-28T23:16:38.000Z","size":39,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-18T03:50:54.774Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/testdriverai.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-01T14:08:13.000Z","updated_at":"2024-10-02T23:34:39.000Z","dependencies_parsed_at":"2024-09-12T06:10:48.754Z","dependency_job_id":null,"html_url":"https://github.com/testdriverai/testdriver-web","commit_stats":null,"previous_names":["dashcamio/testdriver-web","testdriverai/testdriver-web"],"tags_count":7,"template":true,"template_full_name":null,"purl":"pkg:github/testdriverai/testdriver-web","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testdriverai%2Ftestdriver-web","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testdriverai%2Ftestdriver-web/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testdriverai%2Ftestdriver-web/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testdriverai%2Ftestdriver-web/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/testdriverai","download_url":"https://codeload.github.com/testdriverai/testdriver-web/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/testdriverai%2Ftestdriver-web/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267543269,"owners_count":24104538,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-28T02:00:09.689Z","response_time":68,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-24T15:10:40.734Z","updated_at":"2025-10-29T10:03:07.133Z","avatar_url":"https://github.com/testdriverai.png","language":null,"readme":"# TestDriver - Web Quickstart\n\nTestDriver is an AI QA Agent for GitHub. TestDriver allows you to run UI tests on your software using plaintext prompts. Every TestDriver test spawns an ephemeral VM and uploads the results to [Dashcam](https://dashcam.io) for easy debugging.\n\n# Getting Help\n\nTestDriver is made by [Dashcam](https://dashcam.io). Please [join the Dashcam discord for support and questions](https://discord.gg/6TUKZdfCze).\n\n# Getting Started\n\n## Fork This Template Repository\n\nThis template repository has the recommended settings for testing websites in Google Chrome with TestDriver. Begin by forking this template repository. Make the repository public or invite the Dashcam staff into your private repository so we can better support you.\n\n\u003cimg width=\"208\" alt=\"CleanShot 2024-03-08 at 16 59 12@2x\" src=\"https://github.com/dashcamio/testdriver-web/assets/318295/b3d6970b-38ba-4a59-9f4c-c9a90a4047e5\"\u003e\n\n## Add your prompt to the GitHub Action\n\nDashcam is powered by [our TestDriver GitHub Action](https://github.com/dashcamio/testdriver), there are more details there outlining how TestDriver works. Add your test steps to the `.github/workflows/pr.yml` file under `prompt`.\n\n```yml\nname: TestDriver.ai\n\njobs:\n  test:\n    name: \"TestDriver\"\n    runs-on: ubuntu-latest\n    steps:\n      - uses: dashcamio/testdriver@main\n        id: testdriver\n        with:\n          prompt: |\n            1. navigate to youtube.com in google chrome\n            1. search for cat videos\n            1. click the first one\n```\n\n### Tips on Prompting\n\nThe best way to write your prompt is to open an incognito window and perform the test acttions yourself. Write down each step you take.\n\n1. Every step should be a single action\n2. Steps are short and clear. The more information, the more likely TestDriver will be confused.\n3. TestDriver works great with text, icons, shapes, and colors. It doesn't work as well with precise positioning (100px above, next to, etc).\n\n## Test Results\n\nTestDriver reports it's results within the GitHub actions interface. \n\n\u003cimg src=\"https://github.com/dashcamio/testdriver-web/assets/318295/83185198-0550-42c5-ae3e-3734e5e1ddee\" width=\"500\"\u003e\n\nOnce you click `Details` you can view the AI-generated test summary and Dashcam results under `Summary`. Click \"View Recording\" or click on the thumbnail to launch the Dashcam interface.\n\n\u003cimg src=\"https://github.com/dashcamio/testdriver-web/assets/318295/b90d6e20-9ff3-476f-8d78-223fa2f76385\" width=\"500\"\u003e\n\n## Test Replay\n\n### AI Logs\n\nYou may need to select `CLI` under `APP` to view the TestDriver AI logs (marked in yellow). You'll see your prompt is fed to the AI one step at a time. Whenever the `\u003e` appears, that is input to the AI.\n\nYou'll see the AI execute code (marked in green) that it has generated to accomplish your task.\n\nAs you play the video, the logs will playback in real time. Past logs are 100% opacity and future logs are reduced opacity. You can click on any timestamp to navigate to the point in the video where those logs were produced.\n\n\u003cimg src=\"https://github.com/dashcamio/testdriver-web/assets/318295/bc9f339e-949c-4a39-9314-14ddbbd356ae\" width=\"500\"\u003e\n\n### Chrome Logs\n\nThe Chrome console logs and network requests recorded from the test are available under the \"Chrome\" tab.\n\n\u003cimg src=\"https://github.com/dashcamio/testdriver-web/assets/318295/70d3e77c-342f-46cc-95c1-5765bc1fa993\" width=\"500\"\u003e\n\n## Building your application for development\n\nIf you do not already have deploy previews from something like Vercel or Netlify, you may build your application for testing on the machine at run time. Note that TestDriver will clone the repository and branch from which it is run.\n\nIn order to build your application, modify [the `.testdriver/prerun.sh` script](https://github.com/dashcamio/testdriver-web/blob/main/.testdriver/prerun.sh) to include your build steps. Fore example, you may add `npm build` here.\n\nNote that currently causing an exception within `prerun.sh` may cause the test to silently fail.\n- [ ] TestDriver Model V2\n- [ ] Interface updates\n  - [ ] Auto-focus AI logs in Dashcam.io\n- [ ] Test Reporting and Analyitcs Dashboard\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftestdriverai%2Ftestdriver-web","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftestdriverai%2Ftestdriver-web","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftestdriverai%2Ftestdriver-web/lists"}