Skip to content
This repository has been archived by the owner on Aug 10, 2024. It is now read-only.

kwebio/kweb-core

Repository files navigation

Kweb - A Kotlin web framework

Notice of Project Status (June 2024)

Due primarily to recent changes in Sonatype's deployment requirements, and persistent other headaches with JVM ecosystem tooling, I'm no longer able to actively support Kweb.

The last straw was Sonatype breaking my automatic deployment process by changing how it's authenticated, and apparently requiring a paid upgrade to their Pro service to fix it. Over the past two years, most of the time I've spent on Kweb has been dealing with tooling regressions rather than improving the software.

This decision wasn't easy, but it’s become untenable for me to continue maintaining the framework given these challenges.

If you are interested in taking over the project or contributing to its development, please feel free to fork the repository. If you need to contact me I'm @sanity on X and Reddit.

Quick Start

Read the Introduction or Getting Started from the Kweb User Manual.

Why another web framework?

Kweb is designed to make it easy for developers to create modern websites without having to worry about the complexities of communication between the server and the browser. With a unified codebase, you can focus on creating an intuitive and user-friendly interface, rather than spending time on technical details. By streamlining the development process, Kweb makes it easier to build functional and beautiful websites that meet the needs of your users.

How does it work?

Kweb is a remote interface for a web browser's DOM (Document Object Model). With Kweb, you can create and manipulate DOM elements, and listen for and handle events, all using an intuitive Kotlin DSL that mirrors the structure of the HTML being created. Kweb is built on the Ktor framework, which handles HTTP, HTTPS, and WebSocket transport, and is optimized to minimize latency and resource usage on both the server and browser.

Note on Memory Leak Issue

We have identified a memory leak issue that may affect users when using the InputElement class, we're working on a fix but can't make any promises if/when it will be completed. We recommend that you run a memory profiler to see if you're affected.

Example

import kweb.*
import kweb.InputType.text

fun main() {
    Kweb(port = 16097) {
        doc.body {
            val name = kvar("")
            div {
                h1().text("Enter Your Name")
                input(type = text).value = name
            }
            div {
                span().text(name.map { "Hello, $it" })
            }
        }
    }
}