- Docs
- Get started
- Quick Start
- Create a project
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
- Open the project picker in the top bar and create a project (Admins only).
- Enter a unique Project Name and pick the Project Type.
- Click Create; the new project is selected.
- Change the defaults later in Configuration › Project Panel.
- 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 you get and where tests can run. Everything you build (actions, tests, pipelines, reports) belongs to one project.
Create it#
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 cannot create projects; ask your admin.
Name it and pick the type
Enter a Project Name (unique within your company) and a Project Type. Use the table below to choose.
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 (Discover Your App, Record) | Smartest Server, or your agent |
| MOBILE | A native or hybrid Android or iOS app (one project covers both). | Appium inspector on a device or emulator | Your agent with a local device, AWS Device Farm, BrowserStack or SmartTest Device Farm |
| DESKTOP | A Windows or macOS desktop application. | Desktop Recorder through the agent | Only an agent on the computer with the app and Appium installed: Windows or macOS |
One app, one project
What a new project starts with#
You can change all of these later in ConfigurationProject Panel (admins only).
| Setting | Default | What it means |
|---|---|---|
| Test engine | Playwright | Selenium is the other option. |
| Browser | Chrome, latest, headless, 1920×1080 | Tests run without a visible window unless you run on your own agent. |
| Locale | en-US | Browser language for the app under test. |
| Wait / page-load timeout | 30 s / 120 s | How long a step waits for an element, and for a page to load. |
| Parallel threads | 3, or your licence’s Max Thread Count 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. |
| AI | On, with the SmartestQA AI account | You can switch to your own AI provider key. |
| Content | Empty folders and one test case named First Test Case | The tour uses this test case. It counts toward your licence’s test case limit. |
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 and project settings
- Actions with their locators
- Test cases with steps and parameters
- Requirements and their links to tests
- Data sources, Excel files, API requests, database connections and queries
- Test suites and pipelines with their run settings
- Global parameters, tags and past reports
- Created automatically when the founding admin sets a password, 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.”
Didn’t find your answer?Write to support with your project name and what you see on screen.
info@smartestqa.ai