twirl 0,0 travis-ci

The Play Scala Template Compiler

2 years after


Twirl is the Play template engine.

Twirl is automatically available in Play projects and can also be used stand-alone without any dependency on Play.

See the Play documentation for the template engine for more information about the template syntax.


Twirl can also be used outside of Play. An sbt plugin is provided for easy integration with Scala or Java projects.

sbt-twirl requires sbt 0.13.5 or higher

To add the sbt plugin to your project add the sbt plugin dependency in project/plugins.sbt:

addSbtPlugin("com.typesafe.sbt" % "sbt-twirl" % "1.1.1")

And enable the plugin on projects using:


If you only have a single project and are using a build.sbt file, create a root project and enable the twirl plugin like this:

lazy val root = (project in file(".")).enablePlugins(SbtTwirl)

Template files

Twirl template files are expected to be placed under src/main/twirl or src/test/twirl, similar to scala or java sources. The source locations for template files can be configured.

Template files must be named {name}.scala.{ext} where ext can be html, js, xml, or txt.

The Twirl template compiler is automatically added as a source generator for both the main/compile and test configurations. When you run compile or test:compile the Twirl compiler will generate Scala source files from the templates and then these Scala sources will be compiled along with the rest of your project.

Additional imports

To add additional imports for the Scala code in template files, use the templateImports key. For example:

TwirlKeys.templateImports += "org.example._"

Source directories

To configure the source directories where template files will be found, use the sourceDirectories in compileTemplates key. For example, to have template sources alongside Scala or Java source files:

sourceDirectories in (Compile, TwirlKeys.compileTemplates) := (unmanagedSourceDirectories in Compile).value


The name twirl was thought up by the Spray team and refers to the magic @ character in the template language, which is sometimes called "twirl".

The first stand-alone version of Twirl was created by the Spray team.

An optimized version of the Twirl parser was contributed by the Scala IDE team.

Related Repositories



BigPipe streaming for the Play Framework ...



A module for the Play Framework to build highly modular applications ...



A curated list of awesome Gradle plugins and resources for a better development ...



A curated list of awesome Scala frameworks, libraries and software. ...



Twirl templates to link Scala.js output scripts into a HTML page. ...

Top Contributors

pvlugter jroper marcospereira richdougherty gmethvin schmitch gkossakowski julienrf benmccann arnzel adamdecaf Ehwaz dragos retronym lloydmeta pauldraper SethTisue sschaef wsargent


-   v1.0.4 zip tar
-   v1.0.3 zip tar
-   v1.0.2 zip tar
-   v1.0.1 zip tar
-   v1.0.0 zip tar
-   v1.0.0-RC3 zip tar
-   v1.0.0-RC2 zip tar
-   v1.0.0-RC1 zip tar
-   v1.0-M3 zip tar
-   v1.0-M2 zip tar
-   v1.0-M1 zip tar
-   1.2.0 zip tar
-   1.1.1 zip tar
-   1.1.0 zip tar