com.narbase.kunafa:core-metadata

Kunafa

Easy to use, high level framework in Kotlin for front-end web-development

Create web apps without using HTML, CSS, or JavaScript.

Documentation

Find Kunafa Documentation here (Work in progress).

Philosophy

Web apps framework without using HTML, CSS, or JavaScript.

Problem

• Web technologies are pain. Html is verbose, CSS is unexpected, and javascript is.. javascript.
• The no. of technologies a developer needs to learn to write web apps is big. That is, HTML, CSS and JavaScript at the least. Then there are javascript frameworks (react, angular, vue), LESS, SCSS, Haml. There are also packaging tools, gulp, webpack.
• Modern javascript frameworks solve the JavaScript problem, not the front end problem. React use JSX (embedded HTML in javascript) while Angular requires CSS and HTML.

Proposal

An easy to use, high level framework in Kotlin for web development. You do not need to learn the web stack, only the framework to be able to write web apps.

Developer experience

Developers only need to use Kotlin for development.

• You write the view (similar to Android xml layouts) in Kotlin DSL. e. g.

            verticalLayout {
                style {
                    width = matchParent
                    height = matchParent
                    backgroundColor = Color(240, 240, 240)
                }
                button {
                    text = "Click me"
                }
            }

• The view component (similar to Android activity or iOS ViewController) implements certain life cycle functions.
• The framework views contains easy to understand and familiar components and layouts managers. i. e. Button, TextView, TextInput, HorizontalLayout, VerticalLayout and so on.
• The framework makes laying out objects easy, e. g. match parent, wrap content.
• You can wrap any html, css, and js into a framework component to use it inside the framework.

Features

• Intuitive DSL for creating views
• Type safe CSS DSL for complete control of views appearance
• Automatic CSS rule sets caching
• Flexible Components to abstract any logic
• Full Routing support (Links, URL params, Redirecting, Navigation control)
• Very easy to wrap any 3rd party library as Kunafa component

Implementation

• Kotlin transpiles to javascript, and is well designed to support DSLs.
• Code is turned to javascript at compile time, and a basic HTML file loads the generated .js file.
• At runtime, the js file will generate the required HTML, and CSS files containing the whole application.

Getting started

Hello Kunafa! Getting started guide.

To add Kunafa to your project, first you need to add it to your build.gradle file as a dependency.

compile 'com.narbase:kunafa:<latest_version>'

If you have Kotlin Js plugin configured, then you can directly use it the code and Webpack will include Kunafa in the generated bundle.

Now you are ready to use Kunafa in any Kotlin-js project.

For a complete example, check the Kunafa Todo repository

Your feedback is most welcomed. Let us know how is your experience with Kunafa.