Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/wiverson/htmx-demo

Very simple demonstration of the use of htmx with Spring Boot and Thymeleaf.
https://github.com/wiverson/htmx-demo

htmx hyperscript javascript spring-boot thymeleaf thymeleaf-layouts webjars

Last synced: 13 days ago
JSON representation

Very simple demonstration of the use of htmx with Spring Boot and Thymeleaf.

Awesome Lists containing this project

README 

        
# Spring Boot & [htmx](https://htmx.org/) Demo



**It's possible to be a full stack Java developer and provide dynamic, rich application functionality without complex

tools or JavaScript frameworks.**



**Please note that you should check out my other GitHub template, [spring-boot-supabase](https://github.com/ChangeNode/spring-boot-supabase) if 

you are interested in modern full stack Java. It has a Spring Security

implementation based on [Supabase.io](https://supabase.io/)**



[YouTube video](https://youtu.be/38WAVRfxPxI) walking through this repo!



Very simple demonstration of the use of [htmx](https://htmx.org)

with [Spring Boot](https://spring.io/projects/spring-boot)

and [Thymeleaf](https://www.thymeleaf.org). In addition to Thymeleaf, a few examples also use

[Handlebars/Mustache](https://github.com/jknack/handlebars.java) and [j2html](https://j2html.com/).



Build a [Single Page Application (SPA)](https://en.wikipedia.org/wiki/Single-page_application) or just progressively add

dynamic JavaScript functionality to your app without a complicated JavaScript framework.



HTMX + Spring Boot is also a great way to add dynamic HTML functionality to an existing website, perhaps on a completely

different stack (such as WordPress or SquareSpace).



## Using This Project



Requirements: [JDK](https://adoptopenjdk.net/?variant=openjdk17) 17 and [Apache Maven](https://maven.apache.org/).



That's it. No npm, no JavaScript frameworks, no REST services generating JSON that is then converted back to HTML in the

browser.



Once Java & Maven are installed, you can clone off this project, run `mvn spring-boot:run`

and go to [http://localhost:8080](http://localhost:8080). You'll see an index page with links to the various demos.



You don't need to install Node.js, npm, or any other tooling to get rich, dynamic UIs - just html, css, htmx, bootstrap

and a bit of hyperscript.



If you want to be fancy, tell folks that you

are [migrating back to server-side rendering for your SPA applications](https://blog.asayer.io/server-side-rendering-ssr-with-react)

for performance and security reasons.



## Dependencies



[WebJars](https://www.webjars.org) are used to install and manage Bootstrap, htmx and hyperscript. More information

on [using WebJars with Spring Boot](https://www.webjars.org/documentation#springboot).



You can add the WebJars for [htmx](https://htmx.org/) and [hyperscript](https://hyperscript.org/) to your pom.xml like

this:



```xml



    

        org.webjars.npm

        htmx.org

        (get the current version from [htmx.org](https://htmx.org))

    

    

        org.webjars.npm

        hyperscript.org

        (get the current version from [hyperscript.org](https://hyperscript.org))

    



```



Add the following to your application Thymeleaf/HTML to use htmx & hyperscript:



```xml



    

    



```



You don't specify the version number for htmx or hyperscript in the HTML declaration - the versions are are being

managed automatically by the embedded library `org.webjars:webjars-locator-core`.



## Layout



I don't like to repeat myself, so I use Thymeleaf layouts to keep the copy & pasting down to a minimum. Each page uses

a `layout:fragment="content"` declaration to pull in a layout which includes the standard ``



To see an example of

this, [index.html](https://github.com/wiverson/htmx-demo/blob/master/src/main/resources/templates/index.html)

includes the line `` which instructs the

[Thymeleaf Layout Dialect](https://github.com/ultraq/thymeleaf-layout-dialect) to wrap the section with

[layout.html](https://github.com/wiverson/htmx-demo/blob/master/src/main/resources/templates/layout.html).



## Visual Design



This project has been tweaked slightly to make it work better with visual design tools

like [Pinegrow](https://pinegrow.com/). Pinegrow (and other similar tools) expect to find the html templates and all

related assets in a single directory. By default, Spring Boot splits Thymeleaf html templates into one directory

(templates) and static public assets in another (static/public). This completely breaks all visual design tools.



In this project, the Thymeleaf html templates AND the static assets all live in the same folder (static/public). Spring

Security is configured to block paths with the .html extension, so the raw templates aren't visible to users.



Considering that one of the main features of Thymeleaf is the use of valid, complete html, this is a big productivity

advantage for swapping this configuration around. There shouldn't be anything in your html files but basic markup

anyways - we are long, long past the days when JDBC/RDBMS passwords would be stored in JSP files.



## Logging



The application.yaml and logback.xml files are set up to dramatically reduce the log noise for a typical Spring Boot

project.



## Spring Security



This project includes a demo illustrating the use of Spring Security with htmx. When you access a path with /private/

Spring Security will send you to a login page. To create an account, use the sign up page and check the console for a

link you can copy and paste into your browser.



This implementation of Spring Security includes a pretty complete workflow for an email/password based user registration

system. If you pop in a valid SMTP server into the configuration you will have a working:



- User login

- User sign up

- User email validation

- User forgot password/email reset

- RDBMS backed store with properly salted & encrypted passwords



You will find Spring Security implementation details in /htmx-demo/src/main/java/com/devhow/identity path.



The main fancy feature involving htmx is that if a user is logged in to the app with two pages open - let's say page A

and page B. If the user logs out on page A, the session is now invalid for page B. In this demo, page B will now

correctly bounce to the login page if htmx requests any new data.



## Screenshots



The mandatory basic web-front end to do list sample app. Here are the

[Java controller](https://github.com/wiverson/htmx-demo/blob/master/src/main/java/com/devhow/htmxdemo/demo/ToDoList.java)

and the [Thymeleaf template](https://github.com/wiverson/htmx-demo/blob/master/src/main/resources/templates/todo.html).

You may notice that there is a very small amount of [hyperscript](https://hyperscript.org) added to the page to address

event edge cases not handled by htmx alone.



![To Do](/www/images/todo.png)



This infinite scroll demo uses the [java-faker](https://github.com/DiUS/java-faker) library to generate an endless

stream of fake data. The more you scroll, the more data you'll see. In this case, the

[Java controller](https://github.com/wiverson/htmx-demo/blob/master/src/main/java/com/devhow/htmxdemo/demo/InfiniteScroll.java)

is just using Java text blocks to return the data. While very, very simple (and fast!) this isn't really a great idea,

in particular due to potential issues around HTML escaping. For most situations you are much better off using either

Thymeleaf templates, [Handlebars/Mustache](https://github.com/jknack/handlebars.java) or [j2html](https://j2html.com/)

for these fragments.



![Infinite Scroll](/www/images/infinite-scroll.png)



The next two screenshots are for a single

[Java controller](https://github.com/wiverson/htmx-demo/blob/master/src/main/java/com/devhow/htmxdemo/demo/InputCatalog.java)

and [Thymeleaf template](https://github.com/wiverson/htmx-demo/blob/master/src/main/resources/templates/input-catalog.html)

.



Every single input immediately posts back data to the controller. In this case, the response is sent back as an element

to append to the messages block, but it's easy to imagine the response updating other elements - or perhaps just

instantly preserving the user's data with no explicit form submit required.



All the widgets shown are just standard HTML elements. A few of them - like file input - can be a bit tricky to handle

correctly - you want to make sure the submission encoding is set right and that you have right configuration on the

server.



Fun fact: the checkbox can only be set to an indeterminate state via JavaScript (in this case, I'm just

using [hyperscript](https://hyperscript.org)).



![Standard HTML Input Widgets](/www/images/input-widgets-1.png)



These are mostly various text input widgets. In addition to things like automatically showing special keyboards on

various mobile devices, certain fields such as Search are often used for live updates in response to user typing. There

that functionality can be added trivially, without any JavaScript.



![Standard HTML Input Widgets](/www/images/input-widgets-2.png)