Fork me on GitHub

Trimou is a Mustache template engine for Java.


1) Add the pippo-trimou dependency to your pom.xml:


2) Start writing Mustache templates in the templates folder of your application. You may want to review the Trimou docs for any non-standard syntax notes.
Note: The default file extension of a Trimou template is .mustache and it may be omitted from your templates and your Pippo Java code.


This engine includes some useful Pippo integration features and conveniences like…


You can access your translation resources using the i18n helper.

{{i18n ""}}

You can supply arguments to your MessageFormat translation resources too.

{{i18n "" "arg1" "arg2"}}

prettytime (relative time)

The pippo-trimou supports automatically localized prettytime out-of-the-box and it is very easy to use.

Assuming you are providing a java.util.Date instance to prettyTime…


Will produce something like…

3 days ago

You can also automatically format localized dates using standard Java date format patterns.

{{formatTime now}}
{{formatTime now style="short"}}
{{formatTime now style="medium"}}
{{formatTime now style="long"}}
{{formatTime now style="full"}}
{{formatTime now pattern="HH:mm"}}
{{formatTime now pattern="dd-MM-yyyy HH:mm"}}

webjarsAt & publicAt

The pippo-trimou module supports context-aware url generation for your classpath resources using the webjarsAt and publicAt helpers.

<!-- Stylesheets -->
<link href="{{ webjarsAt 'bootstrap/3.3.1/css/bootstrap.min.css' }}" rel="stylesheet">
<link href="{{ webjarsAt 'font-awesome/4.2.0/css/font-awesome.min.css' }}" rel="stylesheet">
<link href="{{ publicAt 'css/style.css' }}" rel="stylesheet">

<!-- Scripts -->
<script src="{{ webjarsAt 'jquery/1.11.1/jquery.min.js' }}"></script>
<script src="{{ webjarsAt 'bootstrap/3.3.1/js/bootstrap.min.js' }}"></script>
<script src="{{ publicAt 'js/main.js' }}"></script>

NOTE: Use of these methods require that you have registered a WebjarsResourceRoute and/or a PublicResourceRoute.

public class MyApplication extends Application {

    protected void onInit() {
        // add routes for static content
        // add other routes

Mustache and AngularJS both use the double-brace notation. There are several options on how to use both technologies together as outlined here.

The pippo-trimou module comes with out-of-the-box support for the following syntax:

{{ng something | or | other}}

Anything after the ng will be re-injected into the template during the compilation phase.

Error Templates

The pippo-trimou module will render special templates for routing problems and exceptions. You may override these templates within your own application (put a file with the same name, to same location, in your application classpath)

  • templates/pippo/404notFound.mustache
  • templates/pippo/500interalError.mustache