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

# Test Repository

The Test Repository is where your tests live. It holds **modules**, and each module holds [Test Scripts](/web-testing/build/creatingscript.md), which in turn hold [Test Steps](/web-testing/build/creatingsteps.md).

A module is simply a folder for related tests — one per feature or area of your application, for example Login, Payments, Search. Grouping tests this way keeps them findable as the project grows.

## Prerequisites

* A project. See [Creating a Project](/web-testing/project-creation/create-project.md).

## Opening the Test Repository

1. Open your project.
2. Click the **Test Repository** tile, or choose **Test Repository** from the **Build** menu.

   ![Test Repository](https://239974709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FycS61vFhJMvvtnJCrDJk%2Fuploads%2Fgit-blob-370e4dad961e744de77dc44ae2c526a20e47c3f6%2Fbuild-module-create-01.png?alt=media)

The page has two tabs:

* **Recently Worked** — the modules and scripts you touched most recently.
* **All Repository** — every module in the project.

Use **Search Module** to filter by name.

## Creating a module

1. Click **New Module +**.

   The **Create Module** window opens.

   ![Create Module window](https://239974709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FycS61vFhJMvvtnJCrDJk%2Fuploads%2Fgit-blob-f5136ef4c21dbd15548376527883c361fcc8e01a%2Fbuild-module-create-02.png?alt=media)
2. Enter a **Module Name**, up to 60 characters.
3. Enter a **Module Key Name**. This is a short prefix used to label the module's scripts.

   The on-screen help reads: "Enter a short prefix of your choice which is easy to identify. (e.g. Module Name - Qyrus, Module Key - QY)". Letters only, maximum four characters.
4. Pick a colour under **Module Identity**. This is the colour the module shows in lists.
5. Enter a **Module Description**, up to 255 characters.
6. Click **Create Module**.

   ![Completed Create Module window](https://239974709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FycS61vFhJMvvtnJCrDJk%2Fuploads%2Fgit-blob-65998dc98ee698f54ea71e690ea0a629d65e0a34%2Fbuild-module-create-03.png?alt=media)
7. The module opens, ready for its first test script.

   ![New module](https://239974709-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FycS61vFhJMvvtnJCrDJk%2Fuploads%2Fgit-blob-fd9286420f1e5f403582dee7220d4e2fda2f758b%2Fbuild-module-create-04.png?alt=media)

## Things worth knowing

* **Name, key and description are all required.** Only the colour is optional.
* **Naming rules**, from the ⓘ button on each field:
  * **Module Name** — "First character should be an alphabet. No special character allowed except
    * \_ and space"
  * **Module Key Name** — "Only alphabets are allowed. Module Key should not be more than 4 characters"
  * **Module Description** — "First character should be an alphabet"
* **TestGenerator+** stays greyed out until the module has at least one script, since it works by analysing the scripts you already have.

## Where to go next

* [Test Scripts](/web-testing/build/creatingscript.md)
* [Managing Modules](/web-testing/build/moduleoperations.md)
* [Test Steps](/web-testing/build/creatingsteps.md)