Skip to content

Installation

Looma needs Java 21+ and Spring Boot 3.3 or newer (see compatibility).

<dependency>
  <groupId>io.github.djamelkorei</groupId>
  <artifactId>looma-spring-boot-starter</artifactId>
  <version>0.1.3</version>
</dependency>
implementation("io.github.djamelkorei:looma-spring-boot-starter:0.1.3")
implementation 'io.github.djamelkorei:looma-spring-boot-starter:0.1.3'

That is the whole setup. Spring Boot auto-configures the engine and the view resolver; put templates in src/main/resources/templates/ as *.looma.html and continue with Getting started.

Only need the engine without Spring? Use looma-core (it depends on spring-expression only).

From GitHub Packages (alternative)

Every release is also published to GitHub Packages. It works the same, but GitHub requires a token even to download, so prefer Maven Central unless you have a reason.

Create a personal access token with read:packages and add it to ~/.m2/settings.xml:

~/.m2/settings.xml
<settings>
  <servers>
    <server>
      <id>github</id>
      <username>YOUR_GITHUB_USERNAME</username>
      <password>YOUR_TOKEN</password>
    </server>
  </servers>
</settings>

Then add the repository next to the dependency above:

<repositories>
  <repository>
    <id>github</id>
    <url>https://maven.pkg.github.com/djamelkorei/looma</url>
  </repository>
</repositories>