> For the complete documentation index, see [llms.txt](https://docs.testvibe.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.testvibe.com/workspace.md).

# Set Up Your Workspace

Your workspace is the container you work in and the projects inside it. A project is created in the app with a name and the site URL(s) to test — all content (features, generated tests, configurations, run history, evidence) lives in TestVibe's cloud. No repository is required.

Most setup happens once per project. After that, your team can create tests, generate Playwright code, and run the suite without repeating it.

## Setup Path

<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>Start a project with a name and the site URL to test.</td><td><a href="/pages/Dmfrmb2QZrZR31qptfws">/pages/Dmfrmb2QZrZR31qptfws</a></td></tr><tr><td><strong>Join an existing project</strong></td><td>Accept a workspace invite or request access from a project link.</td><td><a href="/pages/nDFI6WKjm7iFSLvvPP0y">/pages/nDFI6WKjm7iFSLvvPP0y</a></td></tr><tr><td><strong>Configure environments and App Repository</strong></td><td>Manage test site URLs and the optional source repository.</td><td><a href="/pages/OmsBY1OXulgZoZnkBH4o">/pages/OmsBY1OXulgZoZnkBH4o</a></td></tr><tr><td><strong>Connect GitHub (optional)</strong></td><td>A read-only App Repository for AI context and coverage, and two-way Test Files Sync for this project's tests.</td><td><a href="/pages/qXffKdzuA8cnIjJrCbPM">/pages/qXffKdzuA8cnIjJrCbPM</a></td></tr><tr><td><strong>Manage members</strong></td><td>Invite teammates, create a team workspace, and set Owner, Admin, Member, or Viewer roles.</td><td><a href="/pages/lmHJPuuQS31QjFEevkuu">/pages/lmHJPuuQS31QjFEevkuu</a></td></tr><tr><td><strong>Open the dashboard</strong></td><td>Review project health and decide what to inspect next.</td><td><a href="/pages/UcU5uBUvegDTXtZopaG5">/pages/UcU5uBUvegDTXtZopaG5</a></td></tr></tbody></table>

## What TestVibe Needs

| Requirement                 | Why it matters                                                                                                                                                                    |
| --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Sign-in                     | Email/password, GitHub, or Google — identity only, no repository permissions. Followed an invite link? Sign-in shows the invitation itself and skips separate email verification. |
| A workspace                 | Every user gets a personal workspace; team workspaces are joined by invite, invite link, or created fresh (which can create its first project in the same step).                  |
| A project name and site URL | Your very first project is one screen — no repository required or offered. Additional projects add the same fields, plus an optional advanced source repository field.            |
| A reachable site            | The cloud test session must reach the URL; private apps use a tunnel device.                                                                                                      |

## Where GitHub Fits

GitHub is optional, and there are two separate connections. **Settings → App Repository** links the repository containing your application's own code — read-only; the assistant reads it for context and coverage maps against it. **Settings → Test Files Sync** mirrors this project's own test files — features, specs, and Playwright configs — to a repository you own, with edits flowing both ways. Each is connected independently, and permissions are requested only when you enable it. See [Connect GitHub (optional)](/workspace/install-github-app.md).

## Where To Go Next

If you are setting up for the first time, start with [Create a new project](/workspace/create-new-project.md). If the project already exists, review [Configure environments and App Repository](/workspace/configure-site-url-and-repository.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.testvibe.com/workspace.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.