Routa documentation

Routa needs Go 1.21+ — or download a prebuilt binary from GitHub Releases.

go install github.com/7uyash/routa/cmd/routa@latest

git clone https://github.com/7uyash/routa.git
cd routa
go build -o routa ./cmd/routa

Start your app on any local port, then point Routa at it and open http://localhost:4040.

routa dev 3000

Local inspector (default). routa dev 3000 runs a high-performance local proxy in front of port 3000 and serves the dashboard on 4040. No external setup at all.

Public tunnel gateway. Run a relay edge server, then connect the agent to it to receive a public URL.

routa relay --port 8080 --domain relay.example.com:8080
routa dev 3000 --relay ws://localhost:8080 --name my-app

Flags: routa dev

Flags: routa relay

• Live stream — requests arrive over WebSockets with no page refresh.
• Filters — search by keyword, or filter by method, status class (2xx / 4xx / 5xx) and type (normal vs replay).
• Split-view detail — raw request and response headers, pretty-printed JSON or form bodies, a timing breakdown, and a diff tab for shadow responses.

Re-execute any captured request without curl or Postman. Replay re-sends the exact headers, query and body. Edit & Replay opens a modal where you can change the method or path, add and remove headers, and edit the JSON payload before sending. Replayed entries carry a Replay badge and link back to their parent request ID.

1. Open the Webhook Lab tab in the dashboard.
2. Create an endpoint — you get a unique URL such as https://a7x3.routa.suyashx.dev/webhook/wh_abc123.
3. Point GitHub, Stripe, Shopify, Discord, Slack, Twilio, SendGrid or PayPal at it.
4. Routa detects the provider, checks the signature header, logs delivery timestamps, and lets you replay or intentionally duplicate an event to test idempotency.

Split inbound traffic across several local services from one public URL.

routes:
  - path: "/api/v1/auth/*"
    target: "http://localhost:8081"
  - path: "/api/v1/users/*"
    target: "http://localhost:8082"
  - path: "/*"
    target: "http://localhost:3000"

Routes can also be managed live from the Routes tab in the dashboard.

• Set or remove headers, e.g. inject X-Debug or strip an internal token.
• Rewrite paths and strip prefixes: /api/v1/users → /users.
• Inject query parameters such as ?debug=1&trace=true.
• Mutate nested JSON by dot-path: set user.role=admin, remove user.ssn.
• Return mock responses without ever touching the backend.

mutations:
  - name: "Inject Debug Header"
    match:
      path: "/api/*"
    request:
      set_headers:
        X-Debug-Mode: "true"
      remove_headers:
        - "X-Internal-Token"
      mock_response:
        status: 200
        body: '{"status": "ok", "mocked": true}'

Fixed or jittered latency, forced error rates and status codes, abrupt connection drops and upstream timeouts — configured live in the Simulator panel or in YAML.

simulations:
  - name: "Staging Latency & Error Test"
    match:
      path: "/api/v1/payments/*"
    latency_ms: 250
    jitter_ms: 50
    error_rate: 0.1
    error_status: 503

The primary service answers the real client while a duplicate request goes to the shadow target. The deep differ then compares status codes, headers and nested JSON fields, rendering side-by-side highlights in the Diff tab.

shadows:
  - name: "v2 Migration Test"
    match:
      path: "/api/v2/*"
    shadow_url: "http://localhost:9090"
    compare_response: true

Save the current history as a fixture under ~/.routa/sessions/<name>.json, share it with your team, and replay the requests sequentially with the original inter-request timing preserved.

version: "1"
agent:
  port: 4040
  target: "http://localhost:3000"

routes:
  - path: "/api/v1/users/*"
    target: "http://localhost:8081"

mutations: []
simulations: []
shadows: []

Run any configuration with the --config flag.

routa dev --config routa.yaml