📚 Live Documentation: https://vinipx.github.io/wixy/
WIXY Hub is a high-performance orchestration plane for service virtualization. It decouples the management of WireMock from the actual traffic processing, allowing you to control an entire fleet of local and remote mock engines from a single, unified interface.
Manage multiple environments (Local, Docker, Staging, Cloud) from one place.
- Central Registry: A persistent database of all your mock servers.
- Live Health Tracking: Real-time connectivity status for every node in your fleet.
- Engine Switching: Instantly re-contextualize your entire dashboard to any engine with one click.
A professional-grade terminal console built into your browser.
- Xterm.js Integration: Handles high-throughput traffic without browser lag.
- Background Persistence: Logs continue to be captured even when you switch tabs.
- ANSI Support: Color-coded HTTP methods, statuses, and timestamps for rapid diagnostics.
- Pause & Search: Suspend the stream to inspect payloads or search across 10,000+ lines of history.
A sleek React-based dashboard designed for high-velocity engineering.
- Visual Stub Editor: Full JSON editor with syntax highlighting and validation.
- Runtime Proxying: Dynamically toggle catch-all proxying to real upstream services.
- One-Click Recording: Convert live traffic into persistent stub mappings automatically.
WIXY Hub natively implements MCP, exposing your mock infrastructure as tools for AI agents like Claude Desktop or Cursor. Automate your testing through natural language.
Bootstraps the Hub plus two pre-configured remote engines to see orchestration in action:
./scripts/start-local.sh -3./gradlew bootRunAccess the UI: http://localhost:8080
| Port | Purpose |
|---|---|
| 8080 | WIXY Hub (Management UI, API, Docs, MCP) |
| 9090 | Local Engine (Traffic Plane / Embedded WireMock) |
Automated tests can bypass the "Active Engine" context and target specific servers atomically using the X-Wixy-Target-Server header.
# Target the 'payment-gateway' mock directly via the Hub
curl -X POST http://localhost:8080/wixy/admin/mappings \
-H "X-Wixy-Target-Server: <engine-uuid>" \
-H "Content-Type: application/json" \
-d '{ ...stub-definition... }'# Full Quality Gate (Backend + Frontend + Docs)
./gradlew check
# Generate Test Coverage
./gradlew jacocoTestReportThis project is licensed under the MIT License - see the LICENSE file for details.