KUBE

KUBE - Kotlin Ui Builder.

KUBE is an open-source library, that simplifies your routine of creating internal web interfaces (like an admin panel, or smth else).

Sample webpage written using this library available at https://kube.syncended.dev

Integration

KUBE is available at maven central repository

Maven:

<dependency>
    <groupId>dev.syncended</groupId>
    <artifactId>kube-core</artifactId>
    <version>x.y.z</version>
</dependency>

Gradle:

implementation("dev.syncended:kube-core:x.y.z")

Library packages:

• kube-core
• kube-htmx
• kube-spring
• kube-ktor

Latest release version is available on releases page

How to

Webpage

To create webpage - you should just using high-level funciton render, which creates default KUBE layout, to render webpage.

Each method support RenderMode. Render mode - is an description how element should be rendered.

• PAGE - include built in styles, attach js/css code on page, support scaling and etc
• VIEW_ONLY - just render element, without any resources on it (it will be used to render dynamic elements of HTMX)

Resource mode

Resource mode can be modified over install KubePlugin.Resources plugin

There is 2 possible values:

• FAT - put every used resource in single page. Page will include fonts/css/js code inside
• LINK - webpage will include each resource as link. Resources will be loaded asynchronously. (Better prformance for webpage loading)

Modifier

Common widget settings, like backgroundColor, padding and smth else. Each modifier will be applied to web element, as style/attribute of it.

To create simple modifier - just call Modifier (like a Compose)

text(text = "Sample text", modifier = Modifier.marginLeft(2.rm))
space(Modifier.height(1.rm))

Under the hood, Modifier is a Map<String, Any>, which hold every parameter of widget, and render on applyStyling step