@shaneholloman/aria-bridge

@shaneholloman/aria-bridge

Development-only bridge that captures errors, logs, and optional controls from your app and streams them to a workspace host. Works across web, Node.js, React Native, Roblox/Lua (HTTP), and thin backend SDKs.

Links

• Usage & configuration: docs/usage.md
• Language quickstarts: docs/clients/README.md
• SDK status matrix: docs/clients/status.md
• Roblox / Lua guide: docs/clients/roblox.md

Install (JS/TS)

bun add @shaneholloman/aria-bridge

Quickstart (JS/TS)

• Start the host (writes .aria/aria-bridge.json with url + secret):

  bunx aria-bridge-host
  

• Bootstrap the bridge early in your app:

  import { startBridge } from '@shaneholloman/aria-bridge';
  
  startBridge({
    url: process.env.ARIA_BRIDGE_URL,      // or read from .aria/aria-bridge.json
    secret: process.env.ARIA_BRIDGE_SECRET,
    projectId: 'my-app',
    enableControl: false,                  // opt-in features; see docs/usage.md
  });
  

• In React Native, the same call works; in Node.js you can also enable network/control capture.

Other runtimes (preview / experimental)

Export ARIA_BRIDGE_URL and ARIA_BRIDGE_SECRET (read them from .aria/aria-bridge.json), then run:

Language	Dev one-liner	Docs
Roblox / Lua	bun run copy:lua-client (then require AriaBridge.lua)	guide
Python	python python/examples/basic_usage.py	guide
Go	go run go/examples/main.go	guide
PHP	php php/examples/basic.php	guide
Ruby	bundle exec ruby ruby/examples/basic.rb	guide
Rust	cargo run --example basic --manifest-path rust/Cargo.toml	guide
Swift	swift run --package-path swift AriaBridgeExample	guide
Java (scaffold)	bun run sdk:java	guide

Host in one paragraph

aria-bridge-host is a singleton WebSocket server per workspace. It locks at .aria/aria-bridge.lock, writes .aria/aria-bridge.json with url, port, and secret, and fans out events from bridges to consumers (e.g., Aria, MCP). Start it with bunx aria-bridge-host [workspace-path].

Demos & tests (JS/TS)

• Node demo: bun test (runs demo/node-demo.js, assumes host running)
• Web demo: bun run build then open demo/web-demo.html
• Workspace bridge demo: node demo/workspace-bridge-demo.js /path/to/workspace