---
title: "Create a project"
section: "Quick Start"
description: "Create a SmartestQA project: which type to choose (web, mobile, desktop), the settings a new project starts with, and what the sample project contains."
url: https://docs.smartestqa.ai/en/quick-start-project.html
audience: [customer, admin]
updated: 2026-11-07
keywords: "new project create project type web mobile desktop defaults playwright selenium sample project"
---
# Quick Start: Create a project

Create the project for the application you want to test, choose the right type, and get to know the sample project.

## In short

**On this page you can**

- Create a project for one application under test.
- Choose between WEB, MOBILE and DESKTOP with the project type table.
- See the defaults a new project starts with, such as Playwright and headless Chrome.
- Find out what the sample project contains and what is not copied.

**How to use it**

1. Open the project picker in the top bar and create a project (Admins only).
2. Enter a unique Project Name and pick the Project Type .
3. Click Create ; the new project is selected.
4. Change the defaults later in Configuration › Project Panel .
5. Open the project whose name ends in (Sample) to see a finished example.

A **project** is one application under test. Its type decides how SmartestQA talks to the app, which [step types](https://docs.smartestqa.ai/en/automate-steps.html#step-families) you get and [where tests can run](https://docs.smartestqa.ai/en/concepts.html#where-tests-run). Everything you build ([actions](https://docs.smartestqa.ai/en/discover-actions.html), [tests](https://docs.smartestqa.ai/en/automate-test-cases.html), [pipelines](https://docs.smartestqa.ai/en/schedule-create.html), [reports](https://docs.smartestqa.ai/en/report.html)) belongs to one project.

## Create it

1. **Open Create New Project**

   Open the project picker in the top bar and choose to create a project. Admins with no project at all see the dialog automatically. Users with the [**User** role](https://docs.smartestqa.ai/en/company-settings-roles.html#matrix) cannot create projects; ask your admin.
2. **Name it and pick the type**

   Enter a **Project Name** (unique within your company) and a **Project Type**. Use the table below to choose.
3. **Click Create**

   The button stays disabled until the name is filled.

   You see “Customer Portal project created.” and the new project is selected.

- **Project Name**: unique within the company. Press Enter to create.
- **Project Type**: WEB (default), MOBILE or DESKTOP.
- **Create Sample Project**: copies the demo project. Works once per company.
- **Create**: disabled while the name is empty.

## Which project type?

| Choose | When your app is | How you capture it | Where tests run |
| --- | --- | --- | --- |
| WEB | Anything that opens in a browser: portals, back offices, SaaS, web shops. | Chrome/Edge [extension](https://docs.smartestqa.ai/en/quick-start-connect.html#install-extension) ([Discover Your App](https://docs.smartestqa.ai/en/discover-your-app.html), [Record](https://docs.smartestqa.ai/en/automate-add-steps.html#record-web)) | [Smartest Server](https://docs.smartestqa.ai/en/schedule-where.html#server), or [your agent](https://docs.smartestqa.ai/en/quick-start-connect.html#agent) |
| MOBILE | A native or hybrid Android or iOS app (one project covers both). | [Appium inspector](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#mobile) on a device or emulator | Your agent with a [local device](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#android-emulator), [AWS Device Farm](https://docs.smartestqa.ai/en/project-settings-mobile.html#aws), [BrowserStack](https://docs.smartestqa.ai/en/project-settings-mobile.html#browserstack) or [SmartTest Device Farm](https://docs.smartestqa.ai/en/project-settings-mobile.html#device-farm) |
| DESKTOP | A Windows or macOS desktop application. | [Desktop Recorder](https://docs.smartestqa.ai/en/discover-mobile-desktop.html#desktop) through the agent | Only an agent on the computer with the app and Appium installed: [Windows](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#windows-desktop) or [macOS](https://docs.smartestqa.ai/en/agent-pool-local-setup.html#macos-desktop) |

> **Warning: One app, one project**
>
> Create a separate project for the web portal and for the mobile app of the same product. [API](https://docs.smartestqa.ai/en/automate-steps-api.html), [database](https://docs.smartestqa.ai/en/automate-steps-database.html) and [mail](https://docs.smartestqa.ai/en/automate-steps-mail.html) steps work inside any project type, so you do not need an extra project for them.

## What a new project starts with

You can change all of these later in **Configuration** › [**Project Panel**](https://docs.smartestqa.ai/en/project-settings.html) (admins only).

| Setting | Default | What it means |
| --- | --- | --- |
| [Test engine](https://docs.smartestqa.ai/en/project-settings-test-management.html#engine) | Playwright | [Selenium](https://docs.smartestqa.ai/en/project-settings-engines.html) is the other option. |
| [Browser](https://docs.smartestqa.ai/en/project-settings-test-management.html#browser) | Chrome, latest, headless, 1920×1080 | Tests run without a visible window unless you run on [your own agent](https://docs.smartestqa.ai/en/quick-start-connect.html#agent). |
| Locale | en-US | Browser language for the app under test. |
| [Wait / page-load timeout](https://docs.smartestqa.ai/en/project-settings-test-management.html#timeouts) | 30 s / 120 s | How long a step waits for an element, and for a page to load. |
| [Parallel threads](https://docs.smartestqa.ai/en/project-settings-test-management.html#parallel) | 3, or your [licence’s Max Thread Count](https://docs.smartestqa.ai/en/company-settings-billing.html#licence-details) if that is lower | How many tests of a pipeline run at the same time. |
| Video recording | On | Every run keeps a [video for the report](https://docs.smartestqa.ai/en/report-steps.html#video). |
| [AI](https://docs.smartestqa.ai/en/project-settings-ai.html) | On, with the [SmartestQA AI account](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account) | You can switch to [your own AI provider key](https://docs.smartestqa.ai/en/project-settings-ai.html#own-account). |
| Content | Empty [folders](https://docs.smartestqa.ai/en/automate-test-cases.html#folders) and one test case named **First Test Case** | The tour uses this test case. It counts toward your [licence’s test case limit](https://docs.smartestqa.ai/en/company-settings-billing.html). |

## The sample project

The sample is a complete project you can run immediately. Use it to learn the screens, to demo SmartestQA, and as a reference for how a good project is organised.

#### Copied into the sample

- [Start page URLs](https://docs.smartestqa.ai/en/project-settings-project.html#start-pages) and [project settings](https://docs.smartestqa.ai/en/project-settings.html)
- [Actions](https://docs.smartestqa.ai/en/discover-actions.html) with their locators
- [Test cases](https://docs.smartestqa.ai/en/automate-test-cases.html) with steps and parameters
- [Requirements](https://docs.smartestqa.ai/en/analyze-requirements.html) and their [links to tests](https://docs.smartestqa.ai/en/analyze-test-cases.html)
- [Data sources](https://docs.smartestqa.ai/en/data-source.html), [Excel files](https://docs.smartestqa.ai/en/data-source-datasets.html), [API requests](https://docs.smartestqa.ai/en/api-requests.html), [database connections and queries](https://docs.smartestqa.ai/en/data-source-connections.html)
- Test suites and [pipelines](https://docs.smartestqa.ai/en/schedule-create.html) with their [run settings](https://docs.smartestqa.ai/en/schedule-settings.html)
- [Global parameters](https://docs.smartestqa.ai/en/automate-steps-variables.html#global-parameter), [tags](https://docs.smartestqa.ai/en/schedule-create.html#tags) and [past reports](https://docs.smartestqa.ai/en/report-list.html)

#### Not copied

- [Manual test cases](https://docs.smartestqa.ai/en/automate-test-cases.html#manual-cases)
- Comments

The sample does not count toward your [licence’s project limit](https://docs.smartestqa.ai/en/company-settings-billing.html).

- **Created automatically** when the founding admin [sets a password](https://docs.smartestqa.ai/en/quick-start-account.html#first-login), if the company has no project yet. So most new accounts already have it.
- **Once per company.** After that, **Create Sample Project** is disabled with “[Sample project has already been created for this company.](https://docs.smartestqa.ai/en/quick-start-troubleshooting.html#fix-sample-exists)”
