home
features
quick start
download
documentation
thymol files
configuration
message resources
control parameters
expression objects
thymol types
thymol API
thymol extensions
examples
sessions
say-hello
stsm example
with-dialect
extrathyme
petclinic
news
credits
user forum
issues
browser constraints
other known issues
create new issue
thymeleaf

thymoljs

home

what is thymol?

Thymol is a client-side JavaScript implementation of Thymeleaf, the popular server-side Java template engine.

Thymol 2.0 provides the facility to prototype Thymeleaf 2.1 template based designs without having to run a web application server.

You don't need to be running tomcat or jetty or any other servlet engine, you can do everything on your local file system or network file server or use a plain old web server (like Apache) if you wish.

(Incidentally this site is built using Thymol. To find out how go here.)

how is it licensed?

Thymol is Open Source Software and is distributed under the terms of the Apache License 2.0.

why write it?

Thymol was originally created in order to provide a more accurate static representation of Thymeleaf's dynamic templating capabilities by offering support for Thymeleaf attributes through a statically accessible JavaScript library.

Subsequently Thymol has evolved into a highly capable prototyping system for Thymeleaf based designs.

To read more about why Thymol was started see the static imports page.

how does it work?

At the basic level it can be very simple: you add a single script tag to your Thymeleaf template and load that template directly into your browser.

what about the name?

Thymol is the informal name of the organic molecule 2-isopropyl-5-methylphenol, this chemical provides most of the flavour of the thyme leaf.

Thymol implements most of the functionality of Thymeleaf but doesn't require the use of a server or even a JVM.