Developer Tool

Nexus Forge

Nexus Forge - Adverant Developer Tools documentation.

Adverant Research Team2025-12-083 min read666 words

Development Status: Nexus Forge is currently in Beta v0.2.0 and under active development. While the core architecture is functional, many features described are in various stages of implementation. Metrics (26 browser tools, 5,123 lines of code) reflect current development state. Installation methods and binary distributions are being prepared. Roadmap timelines are estimates subject to change.

Nexus Forge

Nexus Forge is an AI-first visual development IDE that brings enterprise-grade testing capabilities to every developer. Built on the proven VSCode foundation, it extends the familiar editing experience with powerful browser automation, visual regression testing, and intelligent test generation.

Key Features

26 Chrome DevTools MCP Tools

Complete browser automation through Model Context Protocol integration:

  • Navigation: browser_navigate, browser_navigate_back, browser_tabs
  • Interaction: browser_click, browser_type, browser_hover, browser_drag
  • Forms: browser_select_option, browser_file_upload, browser_fill_form
  • Inspection: browser_snapshot, browser_take_screenshot, browser_console_messages
  • Advanced: browser_evaluate, browser_network_requests, browser_wait_for

Natural Language Testing

Write tests in plain English and let AI generate the code:

"Navigate to the login page, enter valid credentials,
and verify the dashboard loads with the user's name"

Generates comprehensive test suites with:

  • Page object models
  • Assertion libraries
  • Error handling
  • Screenshot evidence

Visual Regression Testing

Pixel-perfect comparison powered by pixelmatch:

  • Automatic baseline capture
  • Configurable threshold sensitivity
  • Diff image generation
  • CI/CD integration ready

Test-on-Save Automation

Real-time test execution as you develop:

  • Watches file changes
  • Runs affected tests instantly
  • Live feedback in editor
  • Configurable test patterns

Comprehensive Evidence Collection

Every test run generates:

  • Screenshots at key steps
  • Network request logs
  • Console output capture
  • Performance metrics
  • Accessibility audits

Installation

macOS

Bash
5 lines
# Apple Silicon (M1/M2/M3)
curl -LO https://github.com/adverant/Nexus-Forge/releases/latest/download/nexus-forge-darwin-arm64.dmg

# Intel Mac
curl -LO https://github.com/adverant/Nexus-Forge/releases/latest/download/nexus-forge-darwin-x64.dmg

Windows

Download the installer from GitHub Releases.

Linux

Bash
5 lines
# Debian/Ubuntu
sudo dpkg -i nexus-forge-linux-amd64.deb

# Fedora/RHEL
sudo rpm -i nexus-forge-linux-amd64.rpm

Getting Started

1. Launch Nexus Forge

Open the application and select your project folder.

2. Configure Testing

Create a nexus-forge.config.json:

JSON
9 lines
{
  "testDir": "./tests",
  "baseUrl": "http://localhost:3000",
  "browsers": ["chromium"],
  "screenshot": {
    "mode": "on-failure",
    "fullPage": true
  }
}

3. Write Your First Test

Use the command palette: Nexus: Generate Test from Description

"Test that users can add items to cart and checkout"

4. Run Tests

  • Keyboard: Cmd+Shift+T (Mac) / Ctrl+Shift+T (Windows/Linux)
  • Command Palette: Nexus: Run Tests
  • Test-on-Save: Enable in settings for automatic execution

Architecture

Nexus Forge is built on:

  • Electron: Cross-platform desktop runtime
  • VSCode Core: Full editor capabilities and extension support
  • Playwright: Reliable browser automation
  • pixelmatch: Visual comparison engine
  • MCP SDK: AI tool integration

VSCode Extension Compatibility

Nexus Forge supports all VSCode extensions:

  • Language servers (TypeScript, Python, Rust, etc.)
  • Git integration
  • Themes and icons
  • Debuggers
  • Linters and formatters

Roadmap

VersionFeaturesTarget
v0.3.0Multi-browser supportQ1 2025
v0.5.0API testing suiteQ2 2025
v0.7.0Performance profilingQ3 2025
v1.0.0Enterprise releaseQ4 2025

Enterprise Features

  • Team Collaboration: Share test configurations and baselines
  • CI/CD Integration: GitHub Actions, GitLab CI, Jenkins
  • Test Analytics: Dashboard for test health metrics
  • SSO Support: Enterprise identity provider integration