Skip to content

v0.12.5

Pre-release
Pre-release
Compare
Choose a tag to compare
@bitspittle bitspittle released this 14 Apr 21:53

Exporting

This release improves the setup that occurs behind the scenes related to exporting your Kobweb site.

  • Configured Playwright (an MS library that manages running browsers) to only download exactly the browser it needs, instead of all the browsers. This should significantly reduce initial download times (and memory space required) when you export for the first time.
  • Added support to allow the user to configure which browser gets used for the export.
    • Currently there are three values: Chromium (the default), Firefox, and WebKit.
      • NOTE: WebKit will probably fail to export unless you are running on a Mac.

To configure which browser you use, add the following logic into your build script:

import com.varabyte.kobweb.gradle.application.Browser

kobweb {
   export {
      // Firefox has a much smaller download footprint compared to Chromium
      browser.set(Browser.Firefox)
   }
}

Logging

The Kobweb server has always logged output before, but those logs only went into STDOUT for the server process, which is inconvenient to get access to.

Now, the Kobweb server additionally logs into a target file (using daily rollback policy).

Many aspects of the current logger are configurable. You can do this by modifying your .kobweb/conf.yaml file. Here are all the current parameters you can set, including their current defaults:

server:
  logging:
    level: DEBUG # ALL, TRACE, DEBUG, INFO, WARN, ERROR, OFF
    logRoot: ".kobweb/server/logs"
    clearLogsOnStart: true # Warning - if true, wipes ALL files in logRoot on startup
    logFileBaseName: "kobweb-server" # e.g. "kobweb-server.log", "kobweb-server.2023-04-13.log"
    maxFileCount: null # null = unbound. One log file is created per day, so 30 = 1 month of logs
    totalSizeCap: 10MiB # null = unbound. Accepted units: B, K, M, G, KB, MB, GB, KiB, MiB, GiB
    compressHistory: true # If true, old log files are compressed with gzip

See https://github.com/varabyte/kobweb/#exporting-your-site-in-a-github-workflow for more info