> 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/create-new-project.md).

# Create a New Project

A project is created directly in the app with a name and the site URL to test. All project content — feature files, generated tests, configurations, run history, and evidence — lives in TestVibe's cloud.

If this is the very first project on your account, TestVibe shows this as a single onboarding screen automatically right after sign-in — name, base URL, and optional target framework, nothing else. What follows below is the same minimal form, reached instead from the workspace switcher for adding another project to an account that already has one.

## Before You Start

| Requirement                  | Why it matters                                                                                                                                                                                                                                 |
| ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A project name               | How the project appears in the workspace switcher and project list.                                                                                                                                                                            |
| A base site URL              | The application address your tests open. More URLs can be added later in **Settings → Environments**.                                                                                                                                          |
| Optional target framework(s) | Helps TestVibe read your app's UI; TestVibe also auto-detects on the first visit.                                                                                                                                                              |
| Optional source repository   | Only offered under "Advanced settings" when adding a project from the header — not part of the first-run screen. Lets the assistant read the application code for context. Can always be added later in **Settings → App Repository** instead. |

## Steps

1. Sign in to TestVibe.
2. Open the workspace switcher in the header and select **New project**.
3. Enter a clear project name.
4. Enter the base URL of the site you want to test.
5. Optionally pick target framework(s).
6. Optionally, open **Advanced settings** to add a source repository URL or clone features from an existing project.
7. Create the project.

Creating a project is instant and free — it does not spend credits and does not probe the site. You land in the new project on the Test Suite (Features) with the **Describe a flow** dialog open, ready to write your first test.

## After Creation

Open the new project and confirm:

* the site URL is correct — add more environments in **Settings → Environments**
* teammates who need access are invited from **Settings → Members**

If you want TestVibe to explore the live site and suggest tests to cover it, trigger that from the assistant whenever you're ready — it no longer runs automatically on creation.

If the site is not reachable from the public internet, connect a tunnel device — see [Tunnel devices](/account-settings/tunnel-devices.md).

## Naming Tips

Use a name that makes the project's purpose obvious to teammates — the app or product area it covers, such as `customer-portal` or `billing-checkout`. Avoid temporary names unless you truly intend to replace the project.

## Related Help

* [Choose a source repository (optional)](/workspace/choose-repository.md)
* [Configure environments and App Repository](/workspace/configure-site-url-and-repository.md)
* [Create groups and tests](/create-tests/create-groups-and-tests.md)
* [Quickstart](/quickstart.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/create-new-project.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.