Testlum IDE Project Creation - TestlumFramework/Testlum GitHub Wiki

🧱 Creating a New Project

A project is the main workspace in Testlum IDE where you define and organize your automated tests.
Each project can contain multiple test cases, test data, and settings.

📂 What is a Project?

In Testlum IDE, a project is a container for your test automation logic. It includes:

  • Test cases
  • Folders for grouping tests
  • Environment and runtime settings
  • Optional integrations and metadata

🚀 Creating a New Project

  1. Launch Testlum IDE
  2. From the welcome screen click on Project tab and click on New Project button

project-creation-1

  1. Fill in the project setup form:
    • Project Name — Unique name for your test project
    • Location (automatic) — Here You can provide the path on Your PC where to store a new project
    • Create Git repository — You can automatically create git repository in configured in the IDE account of VCS
    • Language (automatic)
    • Build system (automatic)
    • CI tool (automatic) — For now we provide automatic set up for GitHub Actions for newly created projects. Later during project creation You can upload your tests in repository and trigger testing pipeline using one button (For now only GitHub actions is supported)
    • JDK — Testlum mainly using Java for tests running, so You need to install a proper Java version right in the IDE. For now, we expect not lower than 17 version of Java. You can download Java right here just by clicking Download JDK and choosing a needed version but no lower than 17
    • Add sample code — Enabling this checkbox will automatically populate your project with a ready-to-use folder structure and example tests. You can safely delete or modify the sample tests later — they’re just there to help you get started faster.

project-creation-2

  1. Click Create

✅ Your new project will be created and opened automatically in the workspace.

After completion of all previous steps, You will see a newly created project with filled structure and created tests

🧭 Project Structure

A typical project will have:

  • 📁 Test Scenarios — prepared by our team samples to provide entry point for You
  • ⚙️ Settings — sample configurations for all integrations in Testlum

Each folder contains the .md file with detailed functionality explanation

project-creation-3

You can just press on Run button in the right upper corner to see execution of tests in action

project-creation-4

We also prepared a live learning lessons to guide You through project structure. Remember to check it

project-creation-5

🛠 Tips for Organizing Projects

  • Use folders to group related tests (e.g. “Login Flow”, “Checkout”, “Mobile Tests”)
  • Use meaningful test names to improve readability

📤 Opening an Existing Project

To reopen a saved project:

  1. Click Open Project from the welcome screen or File menu
  2. Choose your project directory
  3. The project will load into the workspace