# Create or connect a project

Once you have selected a repository, TestVibe needs enough project setup to create, generate, and run tests.

You may be starting from a new repository, or you may be connecting a repository that already has TestVibe files or test content.

## Choose The Path That Matches Your Repository

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Create a new project</strong></td><td>Use this when you want TestVibe to create or initialize a repository for UI testing.</td><td><a href="/pages/Dmfrmb2QZrZR31qptfws">/pages/Dmfrmb2QZrZR31qptfws</a></td></tr><tr><td><strong>Connect an existing project</strong></td><td>Use this when the repository already exists and you want TestVibe to use it.</td><td><a href="/pages/nDFI6WKjm7iFSLvvPP0y">/pages/nDFI6WKjm7iFSLvvPP0y</a></td></tr></tbody></table>

## Minimum Setup

For the quickstart, make sure these are available:

* repository access through the TestVibe GitHub App
* a site URL for the application you want to test
* any required API key or repository secret for AI generation
* a default browser and viewport, or permission to use TestVibe defaults

If a value is missing, TestVibe may ask for it when you start generation or a run.

## Site URL

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

Use a URL that the test runner can reach. For example:

* a deployed test environment
* a staging environment
* a shared QA environment

Avoid using a private local URL unless your runner can access it.

## Repository Settings

Repository settings can control details such as:

* default site URL
* website framework
* AI agent
* secrets and variables
* Playwright configurations

You can keep defaults for the quickstart and refine settings later. See [Configure site URL and repository settings](/workspace/configure-site-url-and-repository.md).

## Next

Continue to [Create your first test](/quickstart/create-first-test.md).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.testvibe.com/quickstart/create-or-connect-project.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.