Wailstream

A desktop application for consuming NATS JetStream messages, built with Wails (Go backend + Svelte frontend).

Features

• Kubernetes cluster discovery via kubeconfig
• Automatic port-forwarding to NATS services in K8s namespaces
• NodePort support for direct connectivity
• Localhost NATS detection
• JetStream stream/subject browsing
• Live message consumption with auto-formatting (JSON, Protobuf)
• AES decryption support for encrypted message payloads
• Per-environment credential management
• Configurable port ranges, namespaces, and NATS ports

Prerequisites

• Go 1.21+
• Node.js 18+
• Wails CLI
• A valid kubeconfig (for Kubernetes features)

Development

wails dev

This starts a Vite dev server with hot reload for the frontend. A browser dev server is also available at http://localhost:34115.

Building

wails build

Produces a redistributable production binary in build/bin/.

Configuration

Wailstream reads its config from the user's config directory. Settings include:

• namespaces – Kubernetes namespaces to probe for NATS services
• natsPorts – Ports to identify NATS services
• portRangeStart / portRangeEnd – Local port range for port-forwarding
• initialLoadLimit – Number of messages to fetch on initial consumer start
• nodePortHost – Host address for NodePort connections