# @kui-shell/plugin-logui

> Kui kubernetes log visualization support

Latest version **1.0.17** (published 2020-05-24) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install @kui-shell/plugin-logui
pnpm add @kui-shell/plugin-logui
yarn add @kui-shell/plugin-logui
bun add @kui-shell/plugin-logui
```

## Health

**Score 20/100 (F)** — status: abandoned.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.17 |
| Published | 2020-05-24 |
| First published | 2020-01-07 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | none |
| Module format | ESM + CommonJS |
| Dependencies | 8 |
| Unpacked size | 121.3 KB |
| Known vulnerabilities | 0 (+7 in 3 direct dependencies) |
| Install scripts | no |
| GitHub stars | 31 |
| Author | @starpit |
| Maintainers | oliviaruan, starpit |
| Keywords | kubernetes, kubectl, cli, ui, kui, plugin |

## Links

- npm: https://www.npmjs.com/package/@kui-shell/plugin-logui
- Repository: https://github.com/kui-shell/plugin-kubeui
- Homepage: https://github.com/kui-shell/plugin-kubeui#readme
- Issues: https://github.com/kui-shell/plugin-kubeui/issues/new
- npm.io page: https://npm.io/package/@kui-shell/plugin-logui

## Dependencies (8)

- [debug](https://npm.io/package/debug.md) 4.1.1
- [ansi_up](https://npm.io/package/ansi_up.md) 4.0.4
- [js-yaml](https://npm.io/package/js-yaml.md) 3.13.1
- [@kui-shell/core](https://npm.io/package/@kui-shell/core.md) ^6.0.17
- [@kui-shell/plugin-editor](https://npm.io/package/@kui-shell/plugin-editor.md) ^6.0.17
- [@kui-shell/plugin-kubeui](https://npm.io/package/@kui-shell/plugin-kubeui.md) ^1.0.17
- [@kui-shell/plugin-bash-like](https://npm.io/package/@kui-shell/plugin-bash-like.md) ^6.0.17
- [@kui-shell/plugin-core-support](https://npm.io/package/@kui-shell/plugin-core-support.md) ^6.0.17

## Alternatives

- [@sindresorhus/slugify](https://npm.io/package/@sindresorhus/slugify.md) — 3.7M weekly downloads
- [solid-js](https://npm.io/package/solid-js.md) — 2.7M weekly downloads
- [expo-glass-effect](https://npm.io/package/expo-glass-effect.md) — 2.5M weekly downloads
- [nanoassert](https://npm.io/package/nanoassert.md) — 780.8K weekly downloads
- [@ffmpeg/ffmpeg](https://npm.io/package/@ffmpeg/ffmpeg.md) — 529.5K weekly downloads

## Recent versions

- 1.0.17 (latest) — 2020-05-24
- 1.0.16 — 2020-03-25
- 1.0.15 — 2020-03-24
- 1.0.14 — 2020-03-23
- 1.0.13 — 2020-03-20
- 2.1.6 — 2020-03-19
- 2.1.5 — 2020-03-17
- 2.1.4 — 2020-03-15
- 2.1.3 — 2020-03-13
- 2.1.2 — 2020-03-13
- 2.1.1 — 2020-03-12
- 2.1.0 — 2020-03-12
- 2.0.1 — 2020-03-12
- 2.0.0 — 2020-03-03
- 1.0.12 — 2020-02-21
- … 31 more at https://npm.io/package/@kui-shell/plugin-logui/versions

## README

# Client Template for the Kui Graphical CLI Framework

[Kui](https://github.com/kubernetes-sigs/kui) is a framework for
extending CLIs with graphical enhancements.  If you wish to extend the
framework, either by adding custom commands, custom views, or custom
theming, this is the place to start!

This repository offers a few silly animal-oriented commands and views,
including a way to decorate Kubernetes resources with additional tabs.

## Getting Started with Development

```sh
npm ci
npm run watch
```

This will spawn the Webpack watcher. Once it has finished loading, you
may open a Kui window via `npm run open`. If this works, you are all
set for developing your Kui-based magic.

## Details of the customizations in this client

This [wiki](https://github.com/kubernetes-sigs/kui/wiki) introduces
the ways in which this application enhances Kui. In particular, this
client extends Kui with:

<img src="docs/images/cattab.png" align="right" width="350" title="Showing the Kubernetes decorations">

- Decorations for Kubernetes resources: a `Cat` tab, a 🐶 button, and a 🐱 badge (shown in the upper right with a green background).

- A set of
  [commands](plugins/plugin-example/src/commands)
  that use Kui's built-in views. [More info](https://github.com/kubernetes-sigs/kui/wiki#approaches-for-enhancing-kui)
  - `hello cat` and `hello dog` are simple hello worlds that returns a cat and dog emoji, respectively
  - `hello sidenav` and `hello catnav` which show how to use the multi-tab "sidecar" views, with tabs on top
     and tabs on the left, respectively

<img src="docs/images/catdogwidget.gif" align="right" width="350" title="Showing the CatDogWidget StatusStripe widget">

- A [StatusStripe widget](plugins/plugin-example/src/view/CatDogWidget.tsx) that will be placed along the bottom of the Kui window. [More info](https://github.com/kubernetes-sigs/kui/wiki#approaches-for-enhancing-kui)

### More Documentation on Extending Kui

- [Kui Command Documentation](https://github.com/kubernetes-sigs/kui/wiki/1.-Commands) and [Terminal View Documentation](https://github.com/kubernetes-sigs/kui/wiki/2a.-Terminal-View) uses the [string](plugins/plugin-example/src/view/string), [boolean](plugins/plugin-example/src/view/boolean), and [table](plugins/plugin-example/src/view/table) view as examples of Terminal-oriented command response.

- [TopNavSidecar View Documentation](https://github.com/kubernetes-sigs/kui/wiki/2b.-TopNavSidecar-View) uses [this](plugins/plugin-example/src/view/mmr-example.ts) as an example of TopNavSidecar-oriented command response.

- [LeftNavSidecar View Documentation](https://github.com/kubernetes-sigs/kui/wiki/2c.-LeftNavSidecar-View) uses [this](plugins/plugin-example/src/view/nav-example.ts) as an example of LeftNavSidecar-oriented command response.

## Building for Production: Electron Double-clickables

If you want to build and distribute your own double-clickable
Electron-based clients, then use one of these commands, after which
your clients will be placed in `./dist/electron`.

```sh
npm run build:electron:all # does all of the following...
npm run build:electron:mac:amd64
npm run build:electron:mac:arm64
npm run build:electron:linux:amd64
npm run build:electron:linux:arm64
npm run build:electron:windows:amd64
```

## Building for Production: Hosted Web App

To build a hosted version of Kui, running in a Docker container, use
this command:

```sh
npx kui-build-docker-with-proxy
```

This will generate a Docker image `kui-shell/kui`. To test this
production web app, you can use the script `npx kui-run-cproxy`, and
then visit `http://localhost:9080`.

---
_Source: https://npm.io/package/@kui-shell/plugin-logui · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
