Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/popovanton0/kira

🎛️ Automatically generates UI which allows users to call any function (including composable ones) with any parameter values. Useful for building demo screens in playground apps of design systems
https://github.com/popovanton0/kira

android annotation-processor code-generation demo-app design-system jetpack-compose kotlin ksp playground-app

Last synced: 3 months ago
JSON representation

🎛️ Automatically generates UI which allows users to call any function (including composable ones) with any parameter values. Useful for building demo screens in playground apps of design systems

Host: GitHub
URL: https://github.com/popovanton0/kira
Owner: popovanton0
License: apache-2.0
Created: 2022-05-07T12:03:39.000Z (about 2 years ago)
Default Branch: master
Last Pushed: 2023-07-18T20:18:25.000Z (11 months ago)
Last Synced: 2023-09-04T00:51:19.762Z (10 months ago)
Topics: android, annotation-processor, code-generation, demo-app, design-system, jetpack-compose, kotlin, ksp, playground-app
Language: Kotlin
Homepage:
Size: 4.14 MB
Stars: 4
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome-list - popovanton0/kira - 🎛️ Automatically generates UI which allows users to call any function (including composable ones) with any parameter values. Useful for building demo screens in playground apps of design systems (Kotlin)

README

        # Kira

[![Project Status: Suspended – Initial development has started, but there has not yet been a stable, usable release; work has been stopped for the time being but the author(s) intend on resuming work.](https://www.repostatus.org/badges/latest/suspended.svg)](https://www.repostatus.org/#suspended)

[![Compatible with Compose — 1.2.0](https://img.shields.io/badge/Compatible%20with%20Compose-1.2.0-brightgreen)](https://developer.android.com/jetpack/androidx/releases/compose-foundation#1.2.0)

Kira is an Android library that defines a Kotlin DSL (similar to 

[androidx.preference](https://developer.android.com/guide/topics/ui/settings)) for creating UI that allows users to call

any function (including `@Composable` ones) with any parameter values.

Kira also includes annotation-processor `kira-processor` that __✨automagically✨__ generates UI for functions using the 

DSL.

Library is particularly useful for building demo screens for UI components in playground apps of various design systems.

## Example

```kotlin

@Kira

@Composable

fun TextCard(

    text: String,

    isRed: Boolean,

    skill: Skill?,

    food: Food,

) = TODO()

```

Generated code (only a portion):

```kotlin

kira(TextCardScope()) {

    text = string(paramName = "text", defaultValue = "Lorem")

    isRed = boolean(paramName = "isRed", defaultValue = false)

    skill = nullableEnum(paramName = "skill", defaultValue = null)

    food = enum(paramName = "food")

    injector {

        TextCard(

            text = text.currentValue(),

            isRed = isRed.currentValue(),

            skill = skill.currentValue(),

            food = food.currentValue(),

        )

    }

}

```

Screenshot of the UI demo screen:





## Demo Video



    



## Getting Started

[![Release](https://jitpack.io/v/popovanton0/kira.svg)](https://jitpack.io/#popovanton0/kira)

Add the following code to your project's _root_ `build.gradle` file:

```groovy

repositories {

    maven { url "https://jitpack.io" }

}

```

Next, add the dependency below to your _module_'s `build.gradle` file:

```gradle

dependencies {

    implementation "com.github.popovanton0:kira:LATEST_VERSION"

    ksp "com.github.popovanton0.kira:kira-processor:LATEST_VERSION"

}

```

## Usage

Examples are in

the [source code](https://github.com/popovanton0/kira/blob/master/app/src/main/java/com/popovanton0/kira/demo/MainActivity.kt)

.

### Basic

```kotlin

TODO()

```