README
¶
Litelens
Litelens is a lightweight, native desktop dashboard for managing Kubernetes clusters. It's built with Wails (Go backend + React webview, no Electron), so it stays small and fast while giving you a clean, modern watch-based UI over your cluster.
https://github.com/user-attachments/assets/7afe5c08-fb14-4ca1-ac33-4a2cbe8d2849
Installation
For step-by-step installation instructions, see https://litelensapp.github.io/#installation
Uninstallation
Architecture
Litelens has no HTTP/REST layer between its frontend and backend. Wails auto-generates TypeScript bindings for every exported Go method, so the React frontend calls Go directly as if it were a local async function; Go, in turn, watches the Kubernetes API via informers and pushes live updates back to the frontend as Wails events, rather than the frontend polling for changes.
- Request/response: the frontend calls a bound Go method (e.g.
GetPods(namespace)) through the Wails-generated bindings; Go runs it and returns the result over the same call, same as awaiting a local function. - Push updates: Go's informers watch the cluster in the background and
emit Wails events (e.g.
pods:update) whenever cluster state changes; the frontend's per-resource event hooks subscribe to these events and merge the pushed payload into the existing TanStack Query cache, so views stay live without re-polling.
Contributing
We welcome contributions! See CONTRIBUTING.md for setup, testing, and PR guidelines. Please also review our Code of Conduct and Security Policy.
License
Litelens is licensed under the Apache License 2.0.
Documentation
¶
There is no documentation for this package.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
litelens-install-helper
command
|
|
|
internal
|
|
|
kube/nsscope
Package nsscope provides a generic, resource-agnostic engine for backing a client-go lister with either a single cluster-wide informer or a set of per-namespace informers, rebuildable at runtime as a caller's namespace filter changes.
|
Package nsscope provides a generic, resource-agnostic engine for backing a client-go lister with either a single cluster-wide informer or a set of per-namespace informers, rebuildable at runtime as a caller's namespace filter changes. |
|
lib/github_release
Package githubrelease provides GitHub-release download primitives shared by every consumer that fetches releases/assets from GitHub: the plugin installer (internal/plugin), the self-updater (internal/updater), and internal/app's OS-specific update installers.
|
Package githubrelease provides GitHub-release download primitives shared by every consumer that fetches releases/assets from GitHub: the plugin installer (internal/plugin), the self-updater (internal/updater), and internal/app's OS-specific update installers. |
|
lib/ratelimiter
Package ratelimiter provides a typed error for GitHub API rate-limit (HTTP 403) responses, shared by any package that talks to the GitHub API.
|
Package ratelimiter provides a typed error for GitHub API rate-limit (HTTP 403) responses, shared by any package that talks to the GitHub API. |
|
storage
Package storage resolves the on-disk directory Litelens uses for persistent app data (settings, installed plugins).
|
Package storage resolves the on-disk directory Litelens uses for persistent app data (settings, installed plugins). |
|
packages
|
|
|
core
module
|