# Projects

1. You must have a **QApilot** account: If you haven't already, You can contact our [support team](https://qapilot.io/) to express your interest in trying out QApilot. Our team will reach out to you with the next steps.
2. App Framework of the respective mobile application that you are testing. Click on the [App Frameworks](https://technostacks.com/blog/mobile-app-development-frameworks/) for more information.

***

#### How to Create a New Project? <a href="#how-to-create-a-new-project" id="how-to-create-a-new-project"></a>

1. On the Projects Home page, click the Add+ icon on the top-right corner beside the Filter icon as shown below.

2. A side window overlaps the Home page to Create Project as shown below.\
   ​

   <figure><img src="/files/Zb2DtDDxs7PzebJCHQql" alt=""><figcaption></figcaption></figure>

3. As you can see above, Enter all the required fields: Project Title, APP Framework, Description, Project Logo, and Select Team.

4. Upload the App Framework of the respective mobile application you are testing and provide the necessary details for the project.&#x20;

5. An app framework, short for application framework, refers to a set of pre-built software components, libraries, and tools that provide a structured foundation for developing software applications.&#x20;

6. These frameworks provide a structured environment and tools for designing, developing, and running automated tests, enabling testers and developers to efficiently verify the functionality, performance, and reliability of their applications. If you are not aware of the App Framework of the respective mobile application, Please contact your Application Development Team.

7. Enter Description

8. Upload Product Logo: The preferred image size should be a maximum of 2 MB (SVG, PNG, or JPG).

9. Enter the required details and click the Create button for a new Project creation. The below Success Message will be displayed: QApilot runs on the Appium model, which is used for Automating Native, mobile web, and hybrid applications on iOS and Android platforms. You can select whether you want to test for Android, iOS, or a combination of both.\
   ​

   <figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FCpG6ulqBdX7cBHNX7qkS%252FCreate%2520New%2520Project%25203.png%3Falt%3Dmedia%26token%3D0eb5b0ac-420a-4cd2-9bf2-59d7cac427b7&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=e9ab357b&#x26;sv=2" alt=""><figcaption></figcaption></figure>

10. Once it is created, it appears as an info card on the Projects tab Screen.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FFhJUPQvh8vUvW9hM2ci0%252FCreate%2520New%2520Project%2520image%25204.png%3Falt%3Dmedia%26token%3D969013e2-ffc5-4f32-8457-e22266fdf7c8&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7bf20f00&#x26;sv=2" alt=""><figcaption></figcaption></figure>

***

### How To Filter the Projects? <a href="#how-to-filter-the-projects" id="how-to-filter-the-projects"></a>

1. On the Projects Home page, click the Filter icon beside the Quick Search box.
2. It will display two filtering fields, App Framework and Status. The criteria are selected from the dropdowns.<br>

   <figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FwQl95lzceSRfmVlUao5C%252FFilter%2520Project%2520image%25201.png%3Falt%3Dmedia%26token%3Dc0a4d41e-134d-47bd-8baf-9c14e318ce37&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=890e56ea&#x26;sv=2" alt=""><figcaption></figcaption></figure>
3. Click the Apply button to fix the criteria. The below output is shown as per the filter criteria.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252Fb6i6EdmKrpEgLDDudhLA%252FFilter%2520Project%2520Image%25202.png%3Falt%3Dmedia%26token%3De9fd7bf4-2026-4ce2-b24f-0b3002064af5&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=2c4d8624&#x26;sv=2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252F7mrNgdY9J05LvB17qqyw%252FFilter%2520Project%2520Image%25203.png%3Falt%3Dmedia%26token%3Dd8603bed-d101-46ed-9439-05d1e16ef513&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=38d67b1d&#x26;sv=2" alt=""><figcaption></figcaption></figure>

***

### How to Edit the Project? <a href="#how-to-edit-the-project" id="how-to-edit-the-project"></a>

1. On the Projects Home page, click the three-dot menu.

2. A dropdown appears as shown below.<br>

   <figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FZBfTNLYG3IUHttwL1A1g%252FEdit%2520Project%2520image%25201.png%3Falt%3Dmedia%26token%3Ddd03dd19-0e8a-4dfd-a7e9-d456c027ed0b&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=84b52b0c&#x26;sv=2" alt=""><figcaption></figcaption></figure>

3. Select the Edit icon to make the required changes.

4. A side window is displayed overlapping the Home page.<br>

   <figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FaWCosNNb8cJ9eyooSbw4%252FEdit%2520Project%2520Image%25202.png%3Falt%3Dmedia%26token%3Dbe28dda7-b398-4648-8ca6-2290ac3b54da&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=fc6b3e8a&#x26;sv=2" alt=""><figcaption></figcaption></figure>

5. Make the required changes. Click the Update button to make the changes effective.

***

### How To Attach a New Team to the Projects? <a href="#how-to-attach-a-new-team-to-the-projects" id="how-to-attach-a-new-team-to-the-projects"></a>

1. On the Projects Home page, click the three-dot menu.
2. A dropdown appears as shown below.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252Fct3SWgSTbPwYvhBw12KT%252FAttach%2520New%2520Team%2520Image%25201.png%3Falt%3Dmedia%26token%3D10c0a7f9-c447-4e05-b0fa-52a33732acbf&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=95fdb7ec&#x26;sv=2" alt=""><figcaption></figcaption></figure>

1. Select the Team icon to make the required changes.
2. A side window is displayed overlapping the Home page to Attach Team.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252Fp13qKQfEGAi7zTOYVtBJ%252FAttach%2520Team%2520Image%25202.png%3Falt%3Dmedia%26token%3Df935f0ec-1f1c-450a-8333-188b6b44c5cd&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=826b5182&#x26;sv=2" alt=""><figcaption></figcaption></figure>

1. For the Select Team field, the user can attach a New team, or Select a team from the existing dropdown by using the respective toggle bar.
2. Click the dropdown and select a Team from the list. Click the Create button.
3. A New Team is attached to the respective Project as shown above. A new Team can be created and attached to the project.
4. On the Attach Team window, opt for New under the Select Team field.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FsX5D17tDeVTx41otL34w%252FAttach%2520a%2520New%2520Team%2520Image%25203.png%3Falt%3Dmedia%26token%3D87d294bd-4e1b-46c1-8457-fad808e6d726&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7a48841b&#x26;sv=2" alt=""><figcaption></figcaption></figure>

1. Enter a Team Name. Select the Appearance from the given choices.
2. On the Members fields, select the member from the dropdown.
3. Select the Role from the next dropdown.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FQOZjWX4VebJJ2Q0ylvnZ%252FAttach%2520a%2520New%2520Team%2520Image%25204.png%3Falt%3Dmedia%26token%3Dc54873f3-2f70-46f5-abf9-c01428a93092&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7865bec7&#x26;sv=2" alt=""><figcaption></figcaption></figure>

1. Click the Invite button to add that member to that new Team. Repeat the same procedure for adding every new Team member as per the requirement.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FXcA2xWsBZI8xVQkEalIg%252FAttach%2520a%2520New%2520Team%2520Image%25205.png%3Falt%3Dmedia%26token%3D2eb12be6-7744-4477-87fe-91ee4d6fef86&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=91a5bb72&#x26;sv=2" alt=""><figcaption></figcaption></figure>

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252FBaEtkuNS4y4FRtfPKZof%252FAttach%2520a%2520New%2520Team%2520Image%25206.png%3Falt%3Dmedia%26token%3D63ab1188-add1-41ca-a9a2-c832db154f33&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=9428b65e&#x26;sv=2" alt=""><figcaption></figcaption></figure>

1. Click the Create button to Attach a new team. The New Team is attached.

***

### How To Disable/Delete a Project? <a href="#how-to-disable-delete-a-project" id="how-to-disable-delete-a-project"></a>

1. On the Projects Home page, click the three-dot menu.
2. A dropdown appears as shown below.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252F8fuY5Mfq69MgcbKCqPqT%252FDisable%2520Project%2520Image%25201.png%3Falt%3Dmedia%26token%3D8c4d4381-1da8-4cc6-a0c4-9ad5e2c5599f&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=e3fc9d02&#x26;sv=2" alt=""><figcaption></figcaption></figure>

1. Select the Disable option. A confirmation message will appear as shown below.

<figure><img src="https://docs.qapilot.io/~gitbook/image?url=https%3A%2F%2F1727045651-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Ff7DuCvkprTM62hS3tKQF%252Fuploads%252Fig25d2Sum2di1FSpXxOT%252FDisable%2520Project%2520Image%25202.png%3Falt%3Dmedia%26token%3Dbe504b0d-063a-420a-84c6-7173a1934e14&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=52a27538&#x26;sv=2" alt=""><figcaption></figcaption></figure>

1. Click the Yes button to proceed with the action. Accordingly, the Project is disabled.

Deleting a Project will delete:

* All Frameworks within this Project.
* All Test cases, Elements, Test data profiles, Custom functions, Uploads, Test suites, Test plans, Run results, and Environments associated with this project.

### Inside Projects

Once a project is created, you will be greeted with a menu that enables you to proceed with testing your mobile application. Note that the default landing menu item after project creation is "Recording". You can choose to start your testing journey from recording or take a step back start from "Crawler".&#x20;

<figure><img src="/files/ejsNVDZV8vqWPXJlZAqB" alt=""><figcaption></figcaption></figure>

Learn more about each of the menu items in detail in the following pages.&#x20;

* Crawler
* Recording
* Test Case
* Test Suite
* Execution


---

# 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.qapilot.io/detailed-documentation/projects.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.