Writing features

A feature in VisualQ is a single .feature file that contains one or more scenarios, each describing a behaviour with Given / When / Then steps.

Creating a feature

1. Open your project, click FRT in the sidebar, then New feature.
2. Pick a name (e.g. Sign in flow) and an optional description.
3. The editor opens with a starter scenario you can replace.

Gherkin syntax

VisualQ supports the standard Gherkin keywords:

• Feature: — top-level title
• Background: — steps run before each scenario
• Scenario: / Scenario Outline: — a single user journey
• Examples: — table of values for outlines
• @tag — annotations used for filtering

Feature: Sign in flow

  Background:
    Given I open the homepage

  @smoke
  Scenario: Successful sign in
    When I click on "Sign in"
    And I fill "email" with "alice@example.com"
    And I fill "password" with "Sup3rS3cret!"
    And I click on "Submit"
    Then I should see "Welcome, Alice"

Multilingual Gherkin

VisualQ supports Gherkin in English by default and automatically detects French (Étant donné, Quand, Alors), Spanish, German, Italian, Portuguese, Dutch, Polish, Russian, Japanese, and Chinese keywords.

To force a language, add the language header on the first line:

# language: fr
Fonctionnalité: Connexion

  Scénario: Connexion réussie
    Quand l'utilisateur clique sur "Se connecter"
    Et l'utilisateur remplit "email" avec "alice@example.com"
    Alors le message "Bienvenue" doit s'afficher

Browsers, viewports, base URL

Each feature has its own:

• Base URL (defaults to the project's environment URL).
• Browser list (chromium, firefox, webkit).
• Viewports (default: desktop 1280×800).
• Default timeout (15 s, applied to every step).

Edit them from the Settings drawer in the feature editor. Browser and viewport changes apply to every subsequent run.

Importing existing .feature files

Drag-and-drop or paste the contents of an existing .feature file in the editor. VisualQ will parse it client-side, persist the feature, and trigger a background AI compilation pass to generate the missing step definitions.