2026-06-09 22:04:38 -03:00

Ukuvota

Ukuvota

Ukuvota helps a group compare proposals using scores from -3 to +3. Negative scores carry a chosen weight so resistance stays visible. Every new process includes Status quo and Repeat process, explicit abstention, timed phases, quorum and tie handling.

This version collects decisions on one device. Save a ballot and choose Next participant to hand over the device; tap a saved participant to edit their ballot. Names are labels, with separate saved participant identities. Online sharing, remote synchronization and server permissions are not connected.

The maintained application is Ziran using current Kryon widgets, with one Frame shared by Linux, browser and Android hosts. Android's small C/Java bridge supplies the native data directory and keyboard input. Dependencies are pinned in ziran.lock; there is no vendored UI or parallel legacy client.

Project links: website, itch.io. Source changes do not imply these hosted versions have been updated.

Build and check

Install the Ziran compiler using its make install-user command. Clone this repository normally; no submodules are required. Linux needs a C compiler, CMake, pkg-config, Python 3, SDL2, Cairo and SQLite development packages. Ziran builds the pinned toolchain and resolves package dependencies.

make test                 # source checks, native/portable core tests, private-display smoke
make run                  # build and open the Linux app
make install              # install under ~/.local
make deb                  # build a Debian package for this machine
make appimage             # requires linuxdeploy and appimagetool in PATH

For development in canonical organization checkouts, use an ignored ziran.local.toml:

[overrides]
ziran = "../../ziranlang/ziran"
kryon = "../../kryonlabs/kryon"
sqlite = "../../ziranlang/packages/sqlite"
daochi_client = "../../ziranlang/packages/daochi-client"
kss = "../../kryonlabs/packages/kss"

Release builds use the exact lock without local overrides. The compiler rejects --locked while overrides are present. CI installs the compiler revision in the lock and builds without this file.

The browser build needs Emscripten (tested with 6.0.6), Tcl and CMake:

make web                  # HTML, JavaScript, Wasm and both distribution ZIPs
make serve                # http://127.0.0.1:8080
make site                 # static site and embedded app in build/site
make web-test             # complete browser flow in both packaged versions

EMCC and EMCMAKE can select Emscripten tools; the default is ~/emsdk/upstream/emscripten. Browser data lives in IndexedDB under the app's origin. Use Download backup before clearing browser data. If saving fails, keep the page open and download the backup, then use Retry saving. Browser text fields use native editing, including selection, paste, IME and touch keyboards. System appearance follows the browser's color preference.

The browser tests need Node 22, Chromium, Xvfb, xauth, Tesseract OCR and Pillow. They use a disposable profile and private display, recognize rendered controls, and verify proposals, distinct voters, ballot editing, ties, quorum, mobile touch input, reload persistence and downloaded SQLite backups. Both the web distribution and the website's app path run through the same tests. To verify a deployed website with disposable browser data, run UKU_WEB_URL=https://uku.waozi.xyz node tests/web_test.mjs --site. The site's HTML headers prevent hosting proxies from injecting scripts. Keep no-transform on HTML responses when configuring another host.

Android needs JDK 17 or newer, Android SDK 36, NDK 28.2.13676358 and CMake 3.22.1:

make android
sh scripts/android-build.sh -Puku.onlyAbi=arm64-v8a
ANDROID_TASK=assembleRelease sh scripts/android-build.sh -PfDroidBuild
ANDROID_TASK=bundleRelease sh scripts/android-build.sh -PfDroidBuild

The last two commands produce unsigned releases. For signed releases provide KEYSTORE_PASSWORD and the Gradle keystore.path/keystore.alias properties. Generated artifacts are under droid/app/build/outputs/.

Existing data

Linux stores uku.sqlite3 in $XDG_DATA_HOME/ukuvota or ~/.local/share/ukuvota. UKUVOTA_DATA_DIR selects an explicit directory. Android uses its private internal files directory.

If an earlier Linux build stored uku.sqlite3 in its working directory, close that app and back up the file. Run the new build with UKUVOTA_DATA_DIR=/absolute/path/to/that/directory to open it in place, or copy it to the new data directory while both apps are closed. Supported schemas upgrade transactionally. An unknown schema is refused without deleting it. Do not run both versions against the same database at once.

Release version

Add a numeric entry at the top of CHANGELOG.md, then run ./update_version.sh to synchronize Android's version name and code. Release tags are created only by the GitHub Actions release workflow.

S
Description
Group decision app for scoring and comparing proposals on one device.
Readme
2.8 MiB
0 Stars 1 Watchers 0 Forks
No results found.
Languages
Ziran 73.8%
JavaScript 8%
Shell 4.6%
HTML 4%
Python 3.6%
Other 6%