Mustache with Spring Boot

In this article, we will focus on using Mustache with Spring Boot application for producing and displaying UI (HTML) for your application.



Mustache is a popular web-based template engine popularity known for its simplicity and cleaner approach. This article will try to cover different aspects of the Mustache while using it as a template engine with Spring Boot application.


1. Maven Dependencies

To enable support for Mustache with Spring Boot, add Spring Boot starter to the project pom.xml.


spring-boot-starter-mustache will ensure that all required dependencies to use Mustache are in the classpath of the project.


2. Spring Boot Mustache Project Layout

This is how the project layout will look like for the Spring Boot Mustache application.

├── pom.xml
└── src
    ├── main
    │   ├── java
    │   │   └── com
    │   │       └── javadevjournal
    │   │           ├──  
    │   │           ├── controller
    │   │                 └──
    │   │          
    │   │              
    │   │               
    │   └── resources
    │       ├──
    │       ├── static    
    │       └── templates
    │           ├── header.mustache
    │           ├── product.mustache
    │           ├── footer.mustache
    └── test
         └── java
              └── com
                   └── javadevjournal


3. Mustache HTML Templates

Let’s create a simple HTML template using Mustache which we will use in our sample Spring Boot web application. We are using a modular approach to build our Spring Boot web application. The main template for this post is split into following three parts


3.1 Header

Header parts contain the head and starting body for the HTML template.

<!DOCTYPE html>
<html lang="en">
    <meta charset="UTF-8">
    <title>Sample Spring Boot application with Mustache</title>


3.2 Footer



3.3 Main HTML Template

<h1>Mustache with Spring Boot</h1>
<div>Product List </div>
<b> Product Code: </b>{{code}}
<b> Product Name: </b>{{name}}
<b> Product Description: </b>{{description}}
<b> Product Price: </b>{{price}}

[pullquote align=”normal”]All the above HTML files are ending with .mustache extension. [/pullquote]


4. Controller

We have a simple controller, our controller returns a list of products.

public class MustacheController {

    public String getProducts(final Model model){

        List productList = IntStream.range(0,7).mapToObj(i->getProduct(i)).collect(Collectors.toList());
        return "product";

    private Product getProduct(int i){
        return new Product(String.valueOf(i),"Product"+i, "Sample Description "+i, 100+i);

Our controller creating a dummy list of products and set this product list in the Model class to be available during HTML rendering. Pay close attention to the {{#productList}} and {{/productList}} tags in our HTML, these tags iterate over the list of products filled in the controller and render each element of the list on the UI.


5. Running Application

Once the application is deployed, open the following URL on your browser http://localhost:8080/products, we will see similar output on the browser window.

Mustache with Spring Boot


6. Spring MVC and Mustache

In case you can not use Spring Boot for your web application, integrating Mustache with your Spring MVC application is not complex. Let’s walk through the steps of integrating Mustache with your Spring MVC application.


6.1 Maven Dependencies

Spring Boot automatically take care of adding required dependencies, For the non Spring Boot application, add Mustache maven dependencies.


In order for our Spring MVC application works properly, we need to configure view resolver to use Mustache as template engine.

public ViewResolver getViewResolver(ResourceLoader resourceLoader) {
    MustacheViewResolver mustacheViewResolver
      = new MustacheViewResolver();
    MustacheTemplateLoader mustacheTemplateLoader 
      = new MustacheTemplateLoader();
    return mustacheViewResolver;



In this post, we learned how to use Mustache with Spring Boot application. Mustache is really a powerful yet simple template engine. At the end of this post, we covered the steps for integrating Mustache in non Spring Boot application. Source code for this article is available on the GitHub