Skip to content

tiny-systems/desktop-client

Repository files navigation

Tiny Systems Desktop Client

A desktop application for building and managing Kubernetes-native workflows visually.

What it does

  • Visual flow editor -- drag-and-drop nodes onto a canvas, connect them with edges, and configure each node through JSON schema-driven forms.
  • Module browser -- discover, install, and update Tiny Systems modules directly from the app using Helm.
  • Project and flow management -- create projects, organize flows, and manage widget dashboards for control ports.
  • Runs locally -- connects to your Kubernetes cluster via kubeconfig. No cloud account required.

Prerequisites

  • A running Kubernetes cluster (local or remote)
  • kubectl configured with a valid kubeconfig
  • Helm 3 (recommended -- the app uses Helm to install modules)

Download

Pre-built binaries for macOS, Windows, and Linux are available on the GitHub Releases page.

Alternatively, visit tinysystems.io/download.

Build from source

Requires Go 1.24+ and Wails v2.

wails build

The output binary is placed in build/bin/.

Development

wails dev

This starts a Vite dev server with hot reload for the Vue 3 frontend. The Go backend rebuilds automatically on changes.

How it works

The desktop client reads your kubeconfig and talks to the Kubernetes API directly -- the same way kubectl does. Tiny Systems modules are packaged as Helm charts; installing a module deploys it as a pod in your cluster. Each node in a flow corresponds to a TinyNode custom resource. The client watches these resources and renders the flow graph in real time using Vue Flow.

Related repositories

Repository Description
module Operator SDK for building Tiny Systems modules
common-module Core components (cron, inject, signal, ticker, etc.)
http-module HTTP server and client components
kubernetes-module Kubernetes resource management components
communication-module Email and messaging components
encoding-module JSON, Base64, and other encoding components

Links

License

Apache 2.0