test case doc

contents/docs/api-testing/create-api-testcase/index.mdx

@@ -1,32 +1,27 @@
----
-title: 'Creating an API Test Case'
-description: 'Learn how to create a new API test case within an API suite in Robonito.'
----
+## Creating an API Test Case
 
-# Creating an API Test Case
+This guide explains how to create a new API test case using Robonito.
 
-An API test case in Robonito groups one or more API requests together to test a specific scenario or workflow.
+### Adding Test Cases to a Suite
 
-### Prerequisite
+Test cases are systematically organized within suites according to functionality or modules. The type of test cases added depends on the suite type API.
 
-Before creating an API test case, ensure you have already created an API suite to contain it. If you haven't, see [How to Create an API Suite](../suites).
 
-### Steps to Create an API Test Case
+#### Follow the steps below to create a Test Case
+
 
-1.  **Open Test Explorer:** Navigate to the dashboard page and click the second icon in the sidebar to open the test explorer.
-    ![Open Test Explorer](/api-testing/test-explorer-instruction.png)
-
-2.  **Access Suite Menu:** In the test explorer's suite list, locate the API suite where you want to add the test case. Click the action menu button (usually represented by three dots or similar) associated with that suite.
-    ![Access Suite Menu](/api-testing/api-suite-menu-item.png)
-
-3.  **Add Test Case:** From the action menu, select the **Add Test Case** option. A modal window or form will appear. Fill in the required details for your new test case (e.g., name, description) and confirm its creation.
-    ![Add Test Case Button](/api-testing/create-testcase-button.png)
-
-4.  **Add Initial Request:** Once the test case is created, it will likely be empty. To make it functional, you need to add at least one API request. Click the **Add Request** button. A request holds all the configuration details for a single API call (URL, method, headers, body, etc.) within the test case.
-    ![Add Request Button](/api-testing/create-endpoint.png)
-
-### ✅ What's Next?
-
-You have successfully created an API test case and added an initial request. The next step is to define the specifics of that request.
-
-Learn how to [Configure the API Endpoint](./configure-api-endpoint).
+1. **Select Target Suite** Choose an existing test suite from the Target Suite dropdown. You may also type a name to create a new suite where the test case will be added.
+![Target Suite ](/test-case/target-suite.png)
+2. **Enter Test Case Name** Provide a clear and descriptive name in the Test case name field to easily identify the test scenario.
+![Target Suite ](/test-case/test-case-name.png)
+3. **Select Test Type** Choose API as the test case type. This defines the test as an API automation test.
+![Target Suite ](/test-case/api-test.png)
+4. **Add Description (Optional)** Enter a short description explaining the purpose and scope of the test case.
+5. **Select Browser** Choose the browser in which the test will run, such as Google Chrome.
+![Target Suite ](/test-case/browser.png)
+6. **Enter Target URL** Specify the application URL that will be opened when the test execution starts.
+![Target Suite ](/test-case/url.png)
+7. **Select Device** Choose a predefined device preset to define screen resolution and viewport size (for example, Laptop 11 – 1366×768).
+![Target Suite ](/test-case/device.png)
+8. **Auth Test Case (Optional)** Select an authentication test case to inject session cookies. This allows the test to bypass login steps during execution.
+9. **Create Test Case** Click the Create button to save the test case. Once created, the test case becomes available for adding steps and execution.

contents/docs/assertions/index.mdx

@@ -0,0 +1,7 @@
+### Assertions
+
+Assertions are used to validate expected behavior during test execution. **Robonito** allows you to add assertions while recording or after recording by editing a test step.
+
+When adding an assertion, the **Add Assertion** dialog appears, enabling you to choose the assertion type and configure validation rules.
+![Add Assertions](/test-case/add-assertion.png)
+

contents/docs/assertions/page-assertion/index.mdx

@@ -0,0 +1,58 @@
+### Page Assertion
+
+Page Assertions are used to validate page-level properties during test execution. They ensure that the application navigates to the correct page and that the page is loaded as expected.
+
+The **Add Page Assertion** dialog appears when you choose to add a page-level validation during recording or while editing a test step.
+![Page Assertion](/test-case/page-assertion.png)
+
+### Page Assertion Types
+
+Robonito supports the following page assertion types:
+
+
+### Page Title
+
+Verifies the title of the currently loaded page.
+
+### Configuration Options
+
+- **Expected Title*** – Enter the expected page title
+- **Match Type** – Choose how the title should be matched:
+  - Exact Match
+  - Partial Match (if supported)
+- **Case Sensitive** – Enable this option to perform case-sensitive matching
+
+**Use case:**  
+Ensure the user is navigated to the correct page after an action.
+
+
+### Page URL
+
+Validates the URL of the currently loaded page.
+
+### Configuration Options
+
+- **URL*** – Enter the expected page URL
+
+**Use case:**  
+Confirm correct navigation or routing after page transitions.
+
+
+### Add Page Assertion
+
+After configuring the page assertion:
+
+1. Review the expected title or URL
+2. Click **Add Assertion** to attach the page assertion to the selected test step
+
+During execution, Robonito evaluates the page assertion and marks it as **passed** or **failed** in the execution report.
+
+
+### Benefits of Page Assertions
+
+Page Assertions help ensure:
+
+- Correct navigation flow
+- Accurate page rendering
+- Reliable validation of routing behavior
+

contents/docs/assertions/smart-assertion/index.mdx

@@ -0,0 +1,55 @@
+### Smart Assertion
+
+Smart Assertion allows you to define validations using simple, human-readable descriptions. Instead of manually configuring assertion rules, you describe what should be true about the selected UI element, and **Robonito** automatically interprets and applies the appropriate validation logic.
+
+This dialog appears when you choose **Smart Assertion** during recording or while editing a test step.
+![Smart Assertion](/test-case/smart-assertion1.png)
+
+### Create Smart Assertion
+
+The **Create Assertion** dialog enables you to define intelligent assertions using natural language.
+
+
+### Assertion Description
+
+Enter a clear description of what should be true about the selected element.
+
+**Examples:**
+
+- “The login button should be visible and clickable”
+- “The error message should contain the text ‘Invalid credentials’”
+- “The submit button should be disabled”
+
+You can enter up to **500 characters**.
+
+
+### Instructions for Writing Smart Assertions
+
+To create an effective Smart Assertion:
+
+1. Select the target UI element on the page first
+2. Describe what you want to verify about the element
+3. Use clear and specific language such as:
+   - `should be visible`
+   - `should be clickable`
+   - `should contain text`
+4. Save the assertion once the description is complete
+
+The assertion is automatically evaluated during test execution.
+
+
+### Save Assertion
+
+Click **Save Assertion** to attach the smart assertion to the selected test step.
+
+During execution, Robonito evaluates the assertion and marks it as **passed** or **failed** in the execution report.
+
+
+### Benefits of Smart Assertions
+
+Smart Assertions provide:
+
+- Faster assertion creation
+- Reduced manual configuration
+- Clear, readable validations
+- Improved test maintainability

contents/docs/assertions/text-assertion/index.mdx

@@ -0,0 +1,34 @@
+### Choose Assertion Type
+
+Robonito supports two categories of assertions:
+![Text Assertions](/test-case/plain-text.png)
+
+### Content-Based Assertions
+
+Content-based assertions validate text or content displayed on the page.
+
+### Plain Text
+
+Asserts that a specific text appears on the page.
+
+- Supports exact or partial text matching
+
+**Use case:**  
+Validate headings, labels, messages, or static content.
+
+
+### Custom Expression
+
+Asserts text using a custom expression for advanced matching scenarios.
+
+**Use case:**  
+Validate dynamic text such as IDs, timestamps, or formatted values.
+
+
+### Regex
+
+Validates text using regular expressions.
+
+**Use case:**  
+Match complex patterns such as email addresses or dynamically generated strings.
+

contents/docs/assertions/ui-assertion/index.mdx

@@ -0,0 +1,83 @@
+
+### UI / Element-Based Assertions
+
+UI / Element-Based Assertions are used to validate the presence, visibility, count, and styling of specific UI elements on a page. These assertions ensure that UI components are rendered correctly and behave as expected during test execution.
+
+The **Add Assertion** dialog appears when you select **UI / Element-Based** under the assertion type while recording or editing a test step.
+![Text Assertions](/test-case/ui-assertion.png)
+
+### Choose Assertion Type – UI / Element-Based
+
+UI / Element-Based assertions focus on validating DOM elements rather than page content.
+
+Robonito supports the following UI assertion types:
+
+
+### Element Exists
+
+Asserts that a specific element exists in the DOM.
+
+- Validates that the element is present, regardless of visibility
+- Useful for ensuring required elements are rendered
+
+**Use case:**  
+Verify that a header, button, or container exists on the page.
+
+
+### Element Visible
+
+Asserts that a specific element is visible to the user.
+
+- Ensures the element is displayed on the screen
+- Useful for validating UI readiness before interactions
+
+**Use case:**  
+Confirm that a button or text is visible before clicking or reading it.
+
+
+### Element Count
+
+Validates the number of elements matching a selector.
+
+### Configuration Options
+
+- **Expected count value**
+
+**Use case:**  
+Verify the number of items in a list, table rows, or repeated UI components.
+
+
+### CSS Assertion
+
+Validates the value of a specific CSS property for an element.
+
+### Configuration Options
+
+- **CSS property name**
+- **Expected property value**
+
+**Use case:**  
+Ensure correct styling, such as color, font size, or visibility state.
+
+
+### Assertion Configuration
+
+Once a UI assertion type is selected, the **Configuration** panel becomes active.
+
+Depending on the selected assertion, you can configure:
+
+- **Expected Text*** – The expected value associated with the element
+- **Match Type** – How the value should be matched (e.g., Exact Match)
+- **Case Sensitive** – Enable for case-sensitive matching
+
+These settings define how Robonito evaluates the assertion during execution.
+
+
+### Add Assertion
+
+After configuring the assertion:
+
+1. Review the selected UI assertion and configuration
+2. Click **Add Assertion**
+
+The assertion is attached to the selected test step and evaluated during test execution. Results are displayed as **pass** or **fail** in the execution report.

contents/docs/executions/cloud/index.mdx

@@ -0,0 +1,4 @@
+---
+title: 'Cloud'
+description: 'Learn how to validate API responses using assertions in Robonito.'
+---

contents/docs/executions/index.mdx

@@ -0,0 +1,14 @@
+---
+title: Execution with Robonito
+---
+
+# Execution
+
+Robonito provides a powerful and intuitive way to test your APIs, ensuring they function correctly and meet expectations. This section guides you through the various features available for creating, configuring, and analyzing your API tests.
+
+Learn how to:
+
+-   [Create an API Test Case](./create-api-testcase)
+
+
+Dive into the topics below to get started with API testing in Robonito.

contents/docs/executions/local/index.mdx

@@ -0,0 +1,4 @@
+---
+title: 'Local Guide'
+description: 'Learn how to validate API responses using assertions in Robonito.'
+---

contents/docs/installation/index.mdx

@@ -1,12 +1,17 @@
----
-title: Installation
-description: Robonito has two components the desktop app and a cloud executor. We shall share the installation of Robonito Desktop Application. The cloud executor lives in our (cloud) infrastructure with options for on-premise installation available but that is not covered in these docs.
----
+### Installation Guide
+
+This section explains how to install and set up **Robonito** on Windows, macOS, and Linux systems. Follow the instructions for your operating system to get started quickly.
+
+
+### System Requirements
+
+Before installing Robonito, ensure your system meets the following requirements:
+
+### Operating System
+
+- [Download Robonito for Windows](https://robonito-prod-builds.s3.ap-south-1.amazonaws.com/Robonito-Setup-2.5.0.exe)
+ - [Download Robonito for macOS](https://robonito-prod-builds.s3.ap-south-1.amazonaws.com/Robonito-2.5.0-arm64.dmg)  
+- [Download Robonito for Linux](https://robonito-prod-builds.s3.ap-south-1.amazonaws.com/Robonito-2.5.0.AppImage)
 
-The Robonito Desktop App is available for Windows and Mac
 
-## Installation Overview
 
-Download for Window.   
-Download for Mac intel or Mac Silicon.
-Download for Linux.

contents/docs/installation/linux/index.mdx

@@ -1,5 +1,32 @@
-Robonito is currently compatible with Windows and Mac operating systems. At this time, we are not yet supporting Linux, but we appreciate your interest and feedback.
+# Install Robonito on Linux
 
-We are actively working to expand our offerings and hope to bring Linux compatibility in the future. 
+This guide explains how to install and run **Robonito** on Linux systems using AppImage.
 
-Stay tuned for updates!
+---
+
+## System Requirements
+
+Before installing Robonito, ensure your system meets the following requirements:
+
+- **Operating System:** Ubuntu 20.04+, Debian-based, or equivalent
+- **Browser:** Google Chrome (latest version recommended)
+- **Internet Connection:** Required for updates
+- **Permissions:** Execute permission for AppImage
+
+---
+
+## Download Robonito for Linux
+
+- **Linux (AppImage)**  
+  [Download Robonito for Linux](https://robonito-prod-builds.s3.ap-south-1.amazonaws.com/Robonito-2.5.0.AppImage)
+
+---
+
+## Installation Steps
+
+1. Download the Robonito AppImage file
+2. Open a terminal and navigate to the download directory
+3. Make the AppImage executable:
+
+   ```bash
+   chmod +x Robonito-2.5.0.AppImage