Split the kuzuha-style board into a spec, an API, a UI and a distribution zip¶
I rebuilt the kuzuha-style (Ayashii World-lineage) message board into a shape that can be published as OSS. What I put at the center is not the UI but the rules between the UI and the server (the spec). As long as the rules are followed, both the server and the UI can be swapped out. As the first combination, I built a version that runs just by uploading it to a rental server over FTP.
The whole system is called kssw. It is based on the 6umi.net API. Everything is alpha, and the repos will be published after review.
min and full¶
There will be 2 kinds of API (the server side of the board).
| min | full | |
|---|---|---|
| Implementation | PHP 7.4+ / SQLite | Python / PostgreSQL |
| Status | alpha | planned |
| Purpose | Runs just by putting it on a rental server | The full version. Has features min lacks, such as accounts and translation |
- For min, I prioritized how many places it can be deployed. PHP is the most widely available option on rental servers. It needs no DB server and no resident process
- For full, I also considered TypeScript (Node) and Go, and went with Python
- The only things the 2 implementations share are the spec and the tests that check from the outside whether an implementation behaves according to the spec
4 repos¶
- ks-sw-spec: the spec. The rules for the exchange between the UI and the server
- ks-sw-api: the API implementation (min for now)
- ks-kuzuha-ui: the UI. Made only of static files that run in the browser
- ks-kuzuha-alternative: a zip bundling the UI and the min API. Runs just by uploading it over FTP
The API is at the center, and the kuzuha-style UI is one of the UIs that sit on top of it.
Spec¶
- I separated the spec from the implementations so that things don't get confusing as more API implementations and UIs appear
- It contains the spec text, the API definition (OpenAPI), and tests to check against it. Everything is MIT licensed
- The server returns its own version and the features it supports. The UI uses only the supported features
Admin¶
- The main users are AI agents. The locally run command
kssw-admincalls the server's admin API. Results come back as JSON - The browser admin page (
admin.php) is minimal: login, recent posts, deletion and restoration - A view readable without JavaScript and RSS will come after the first release
Setup¶
No execute permissions, path settings or initial password are needed.
- The setup page checks whether the DB or the config file can be read from outside, and warns if they can
- The only config file in the zip is a sample (
config.example.json). To update, you just upload over the existing files, and your own settings are not lost - Mistakes in the config file are shown on the setup page
- The admin password can be created on the
admin.phppage. No Python needed
Demo¶
- It runs on XREA's free plan. Ads are inserted as a condition of the free plan
UI (ks-kuzuha-ui v0.5.0-alpha.1)¶
- The board title is determined by the tags attached to the board. The demo's is "@くずはAlternative"
- The font can be changed in the settings
- The display language is determined in this order: the URL parameter, the viewer's choice, the browser's language
- The PR office (About page) shows the versions of the running UI and API, with links to each one's source
- The list view (standard / tree) is switched from the menu
Color scheme¶
Viewers can choose the background hue and the accent color, and can also make the input fields and the selection use the theme color. Combined with the accent color, this gives a nice duotone. I'm starting to grow attached to it as a product.

- Background hue 195, accent hue 15 at 90% strength, input fields and selection in the theme color
Last time's goal · 2026-10-15-oss-cleanup¶
- Decide the structure of the minimal API, and how to split the repos and what to name them → met
Next¶
- Remake the single commit for publishing, review it, and publish the 4 repos
Created 2026-10-16 · Updated 2026-11-07 · Machine-translated from the Japanese original.