For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create a Project

Create a TestVibe project with a name and the site URL(s) to test before adding your first test.

A project is created right in the app: give it a name and the URL of the site you want to test. No repository is required — all project content lives in TestVibe's cloud.

If this is the very first project on your account, TestVibe shows it to you automatically right after sign-in, as a single screen — there's no multi-step wizard and no repository-connect step here. Connecting a source repository is a separate, later step in Settings → App Repository (see below), not part of creating the project.

Steps

  1. Enter a project name.

  2. Enter the base URL of the site you want to test — the address your tests will open.

  3. Optionally, pick the target framework(s) so TestVibe can better read your app's UI (TestVibe also auto-detects on the first visit).

  4. Create the project.

Creating a project is instant and free — it doesn't spend credits and doesn't probe the site. You land directly in the project on the Test Suite (Features) with the Describe a flow dialog open, ready to write your first test in plain English. See Create your first test.

If you'd rather have TestVibe explore your live site and suggest tests to cover it, you can trigger that from the assistant at any time — it's optional, not automatic. See Assistant.

Site URL

The site URL is the address your generated test will open.

Use a URL the cloud test session can reach. For example:

  • a deployed test environment

  • a staging environment

  • a shared QA environment

If the app is private — behind a VPN or only reachable from your network — install the tvtunnel agent on a machine inside that network. See Tunnel devices.

Source Repository (Optional)

Once your project exists, you can connect a source repository from GitHub, GitLab, or Azure DevOps in Settings → App Repository. It helps the assistant and AI generation understand your app from the code, not just the rendered pages, and is read-only context — your tests and project files still live in TestVibe. Repository permissions are requested only when you connect a repo there — never at sign-in and never during project creation.

Test file sync (mirroring your generated tests two-way to a Git repo) is a separate setting — Settings → Test Files Sync.

Project Settings

Project settings can control details such as:

  • site URLs

  • AI agent and model

  • variables and secrets

  • Playwright configurations

You can keep defaults for the quickstart and refine settings later. See Configure site URLs and project settings.

Next

Continue to Create your first test.

Last updated

Was this helpful?