Skip to main content

TAFLEX JS

The Modular Enterprise Test Automation Framework

Build Status Version License

🎯 Reimagining Test Automation for the Enterprise​

TAFLEX JS is a world-class, modular test automation framework designed to unify your quality engineering efforts across Web, API, and Mobile domains. Built in modern JavaScript (Node.js ESM), it solves the classic problems of monolithic frameworks through a strict Plugin Architecture, the Strategy Design Pattern, and Runtime Configuration Validation.

It is designed not just for writing tests, but for managing quality at scale across multiple autonomous teams.

✨ Enterprise Capabilities​

FeatureArchitectural Benefit
🚀 Interactive ScaffoldingInstantly generate tailored bounded contexts for new teams. No more cloning bloated starter repos.
🧩 Strategy Pattern EngineA unified AutomationDriver interface seamlessly routes commands to Playwright, WebdriverIO, or Axios at runtime.
📄 Hierarchical Locators100% decoupling of selectors from test code using a Global > Mode > Page JSON inheritance model.
🛡️ Type-Safe BoundariesComposed Zod schemas guarantee that environment configurations are valid before execution begins, ensuring fail-fast CI/CD pipelines.
🤖 AI-Agent Ready (MCP)Native Model Context Protocol server. Transform your test suite into an active tool that AI assistants can debug and execute autonomously.
📊 Governance & TraceabilityNative integrations with Allure, ReportPortal, and Jira (Xray) for complete requirement traceability and executive visibility.

🚀 The "Day 1" Onboarding Experience​

Get a production-ready, highly customized framework up and running in your terminal in under 60 seconds.

1. Scaffold​

Launch the interactive builder to select exactly the modules your team needs (Web, API, Mobile, Database, Reporting):

bash <(curl -s https://raw.githubusercontent.com/vinipx/taflex-js-modular/main/scaffold.sh)

2. Install & Configure​

Install your tailored dependencies and fill in the strictly-typed .env file generated for you:

cd my-new-automation-project
npm install

3. Execute​

Start writing business-focused tests immediately using the unified driver API:

npm test

💻 The Unified API Experience​

Regardless of whether you are testing a Web app with Playwright, a Mobile app with Appium, or an API with Axios, the test syntax remains beautifully consistent.

import { test, expect } from '../fixtures.js';

test('Unified Cross-Platform Strategy', async ({ driver }) => {
    // 1. Unified Navigation
    await driver.navigateTo('/login');
    
    // 2. Intelligent JSON Locator Loading
    await driver.loadLocators('login');

    // 3. Platform-Agnostic Element Interactions
    await (await driver.findElement('username_field')).fill('automation_user');
    await (await driver.findElement('password_field')).fill('SecurePass123!');
    await (await driver.findElement('login_button')).click();

    // 4. Fluent Assertions
    const dashboard = await driver.findElement('dashboard_container');
    expect(await dashboard.isVisible()).toBeTruthy();
});

🎯 Who Benefits from TAFLEX JS?​

TAFLEX JS is built to satisfy the needs of every stakeholder in the software development lifecycle:

  • 👨‍💻 Automation Architects: Clean SOLID principles, Composition Roots, and Zod boundaries provide a highly maintainable and extensible architecture.
  • 🕵️‍♀️ QA Engineers: Low-code JSON locator management, powerful unified APIs, and seamless BDD (Gherkin) integration for rapid test development.
  • 🚀 DevOps Engineers: Lean, modular dependencies mean faster Docker builds and lightweight CI pipelines. Zero "heavy browser" downloads for purely API-focused teams.
  • 📊 Engineering Managers: Unified reporting (ReportPortal/Xray) across all platforms brings unprecedented visibility into product quality and team velocity.

📚 Deep Dive​

Ready to master the framework?

TAFLEX JS is open-source software licensed under the MIT License.