HAL-TEST 🤖

The Missing Link in Browser Automation

HAL-TEST is a modern, visual automation framework that bridges the gap between manual QA and technical automation. Built on top of Playwright, it provides a high-performance, node-based interface to build, manage, and scale complex browser workflows without writing a single line of boilerplate code.

📺 See it in Action

🚀 Why HAL-TEST?

Most automation frameworks suffer from "Framework Fatigue": complex YAMLs, brittle selectors, and high barriers to entry. HAL-TEST changes the game:

• Low Code, Pro Power: Use the full strength of Playwright through a visual canvas.
• Zero Vendor Lock-in: Export your flows or run them via the HAL-TEST CLI.
• Self-Healing Ready: Designed to handle dynamic modern web apps with intelligent node logic.
• Built for Teams: Allow manual QAs to build tests that Seniors can audit and scale.

✨ Key Features

🧠 Visual Flow Editor

• Node-Based Logic: 50+ specialized nodes for DOM manipulation, network interception, and AI.
• Smart Connections: Animated execution feedback—watch your test run in real-time.
• Category-Specific UI: Glassmorphic design with 50+ unique icons for instant recognition.
• Viewing the App: Visual Documentation: Detailed guide for nodes, colors, and real-time feedback.

🛠️ Developer-First DX

• Powerful CLI: Integrated terminal tool for CI/CD pipelines (GitHub Actions, Jenkins).
• Network Orchestration: Mock, intercept, and modify XHR/Fetch requests visually.
• Session Management: Persist cookies, local storage, and auth tokens between runs.
• LLM Integration: Semantic validation and AI-powered node generation.

🏗️ Architecture & Tech Stack

• Frontend: React 18, React Flow, Motion 12, TanStack Query.
• Backend: Node.js, Express, Playwright.
• Database: SQLite (local persistence) + IndexedDB (client-side screenshots).
• Monorepo: Turbo + pnpm workspaces.

⚡ Quick Start

The fastest way to get started is using npx. No cloning or installation required:

npx haltest@latest

This will start the backend server, run pre-requisite checks, and open the HAL-TEST studio in your browser.

🏗️ Technical Setup (Development)

Prerequisites

• Node.js 20+ and pnpm

1. Setup

git clone https://github.com/andresguc1/hal-test.git
cd hal-test
pnpm install

2. Configure Guest Mode

For quick local testing without Supabase:

# Set in your .env
AUTH_ENABLED=false
VITE_AUTH_ENABLED=false

3. Run

pnpm --filter backend db:init
pnpm run dev

App: http://localhost:5173/app/
Server: http://localhost:2001

💻 Terminal CLI

Automate your workflows. You can run the CLI directly via npx (recommended) or install it globally.

Running with NPX

# Run a flow by ID
npx haltest@latest cli run <flow_id> --headed

Local Installation

If you prefer a local installation:

cd apps/cli && npm install -g .

🐳 Docker Deployment (Recommended)

To avoid missing system dependencies for Playwright, use Docker:

Bash docker compose up -d --build See DOCKER.md for detailed production setup.

⚡ Developer Workflow

To make contributing easier, we provide unified commands in the root package.json:

Update your Local Repo

Pull the latest changes from GitHub, install all dependencies, and rebuild the frontend monolith in one step:

pnpm run update:app

Port Management & Cleanup

If you encounter EADDRINUSE errors or need to clear the development ports (2001 and 3000), use the unified stop command:

pnpm run stop

The CLI launcher also features smart port detection—it will automatically detect if the backend is already running and connect to it instead of failing.

Publish a New CLI Release

(Maintainers only). This command bumps the patch version, runs the standalone build for the CLI, and publishes it to NPM:

pnpm run release

🤝 Community & Support

Join our Slack: HAL-TEST Talk

Star the Repo: If this project helps you, give us a ⭐!

📄 License

Apache License 2.0 - Created by Andresguc1