Kickside UI — platform navigation API plus admin UI surfaces. Ships the kickside-appearance web component (a System tab) that edits navigation layout, categories, and per-surface overrides backed by kickside.ui settings.

BUSL-1.1 1.3k downloads
Updated 3 days ago Repository
kicksideuiadminappearance

Run

wippy run kickside/ui

kickside/ui

Admin UI surfaces for a Kickside app. Currently the Appearance editor: a self-contained web component (kickside-appearance) that mounts as a System tab and edits the navigation appearance.

It edits the nav layout (vertical / horizontal), custom categories, custom items, and per-surface overrides (hide / reorder / relabel / re-icon), then persists them to kickside.ui settings over /nav/config.

Shape

  • src/_index.yaml — namespace kickside.ui. Declares the nav aggregation API, settings definitions, UI mount (fs.directory + http.static), the view.component, and a ui.settings_tab so the System page discovers the tab without any app-side edit.
  • ui/ — the Vue 3 web component. Builds to static/index.js.

Data

The editor reads /nav/list and writes /nav/config. Those compatibility routes are owned by this module; internally, persisted navigation controls live under the kickside.ui settings namespace.

Build

make build      # cd ui && npm install && npm run build  -> static/index.js
make lint       # wippy lint