Skip to content

kwebio/kweb-core

Repository files navigation

Kweb - A Kotlin web framework

Notice of Project Status (June 2024)

Due primarily to recentchangesin Sonatype's deployment requirements, and persistent otherheadacheswith 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, andapparentlyrequiring 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 onXandReddit.

Quick Start

Read theIntroductionor Getting Startedfrom theKweb 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 theInputElementclass, we're working on afixbut 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

importkweb.*
importkweb.InputType.text

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