Theming

Last updated 27 days ago

Theming

By default KVision includes the standard look and feel. It's modern, elegant and proven in many production environments. Just include kvision-bootstrap module in your build.gradle.kts file. But there are other possibilities as well.

Adding a custom CSS file to your application

You can add a custom CSS file to define your own CSS classes, which can be used throughout your code (almost every component supports the className: String? constructor parameter and the addCssClass(css: String) and removeCssClass(css: String) methods). Of course you can also overwrite and change the standard Bootstrap classes.

You can add as many CSS files as you wish. Just save your *.css files in src/jsMain/resources/modules/css directory and use @JsModule annotation in your main App object.

App.kt

import io.kvision.utils.useModule

@JsModule("/kotlin/modules/css/kvapp.css")
external val kvappCss: dynamic

@JsModule("/kotlin/modules/css/other.css")
external val otherCss: dynamic

class App : Application() {
    init {
        useModule(kvappCss)
        useModule(otherCss)
    }
    
    override fun start() {
    // ...
    }
}

Replacing Bootstrap CSS with a custom one

You can remove BootstrapCssModule initializer from your application and include different CSS file in the main index.html of your application. It can be loaded from any local or remote source.

index.html

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>KVision App</title>
    <link rel="stylesheet" href="css/mybootstrap.min.css" >
    <script type="text/javascript" src="main.bundle.js"></script>
</head>
<body>
<div id="kvapp"></div>
</body>
</html>

index.html

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>KVision Address Book</title>
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootswatch@5.1.0/dist/materia/bootstrap.min.css" integrity="sha256-T8h7oW5tHp4MhFhmRoDI8xjnB2ld89qSgc3s9g8T0uU=" crossorigin="anonymous">
    <script type="text/javascript" src="main.bundle.js"></script>
</head>
<body>
<div id="kvapp"></div>
</body>
</html>

Using KVision without Bootstrap

PreviousRoot Container NextDark mode

Last updated 27 days ago

Adding a custom CSS file to your application

You can add as many CSS files as you wish. Just save your *.css files in src/jsMain/resources/modules/css directory and use @JsModule annotation in your main App object.

App.kt

import io.kvision.utils.useModule

@JsModule("/kotlin/modules/css/kvapp.css")
external val kvappCss: dynamic

@JsModule("/kotlin/modules/css/other.css")
external val otherCss: dynamic

class App : Application() {
    init {
        useModule(kvappCss)
        useModule(otherCss)
    }
    
    override fun start() {
    // ...
    }
}

Replacing Bootstrap CSS with a custom one

You can remove BootstrapCssModule initializer from your application and include different CSS file in the main index.html of your application. It can be loaded from any local or remote source.

index.html

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>KVision App</title>
    <link rel="stylesheet" href="css/mybootstrap.min.css" >
    <script type="text/javascript" src="main.bundle.js"></script>
</head>
<body>
<div id="kvapp"></div>
</body>
</html>

You can create such a file manually or version from sources. To include a local version of Bootstrap, simply place mybootstrap.min.css in the src/jsMain/resources/css directory.

Using free themes from

There are some great free themes ready to use available at . For instance to use Materia (material-like) theme make the following change to your index.html.

index.html

<!DOCTYPE html>
<html>
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <title>KVision Address Book</title>
    <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootswatch@5.1.0/dist/materia/bootstrap.min.css" integrity="sha256-T8h7oW5tHp4MhFhmRoDI8xjnB2ld89qSgc3s9g8T0uU=" crossorigin="anonymous">
    <script type="text/javascript" src="main.bundle.js"></script>
</head>
<body>
<div id="kvapp"></div>
</body>
</html>

Using KVision without Bootstrap

KVision can also be used with no Bootstrap at all. Just exclude all *bootstrap* modules from your build.gradle.kts file. You won't be able to use components from these modules, which depend on Bootstrap's JavaScript and styling. But you can use any other CSS framework (see examples for , and ).