Skip to content

Cleaning up the kuzuha-style UI for open-sourcing

I cleaned up the kuzuha-style UI (kuzuha-ui) so it can be released as OSS. Anything specific to 6umi moved into configuration, and the 6umi-specific features went into a forked extended version.

Moving things into configuration

  • Values specific to 6umi, such as the board name, default tags, links and the API URL, now live in an instance config file (a single JSON file). No 6umi values remain in the code. Without a config, it runs as a neutral board
  • On the API, board and landing side too, the board name and the notification URL are now config values
  • Whether tags are shown: the operator sets the default, and viewers can toggle it in their settings
  • The UI is English by default, with Japanese in a translation file. Viewers can choose the language
  • Also: access keys, and the body length limit (kept in line with the API)
  • Links in the current board's (Streamlit) ?tag= and ?post= format are mapped to routes inside the kuzuha-style UI. Existing links, such as those in notifications, keep working as they are

Filtering by poster name

  • I added poster name to search. It's independent of tags
  • On 6umi the poster name is effectively always blank, so I didn't really want to add this, but I supported it properly
  • Poster name is a field stored JSON-style, but it can be indexed, so filtering is fast

Color themes

Settings page: background hue, accent hue and strength, tags, language

  • Themes are based on the background hue. The accent color is used only for interaction states like hover and pressed
  • Viewers can change the hue and accent on the settings page. The operator sets the initial values
  • For the focus highlight, I went back and forth from a thick double line to a glow a few times, and settled on two stacked 1px lines (in different shades). The edge looks soft even without blur

Text field focus

Using a fork

Extended version: face icons on bot posts, dark input field

  • The minimal version (kuzuha-ui) is a plain OSS UI. 6umi's official UI will be the forked extended version (kuzuha-ex-ui). Face icons, the dark input field and login are only in the extended version
  • The flow goes one way. Fixes go into the minimal version, and the extended version pulls them in. The extended version's differences are kept in separate files
  • Since adding the config file, the only differences from the minimal version are the deploy target and the config file name

Next

  • Decide the structure of the minimal API, and how to split the repos and what to name them

Created 2026-10-16 · Updated 2026-11-07 · Machine-translated from the Japanese original.