keychera / panas.example

project examples using clojure/babashka + htmx

Examples that uses panas.reload

Initially these are examples for panas.reload, now this has become where I experiment all sort of things with clojure(babashka) and htmx

Prerequisite

install babashka

quick babashka installation

bash < <(curl -s https://raw.githubusercontent.com/babashka/babashka/master/install)

How to use

bb --config <any-project-dir>/bb.edn panas.reload

for example, running the project babashka-httpkit

bb --config babashka-httpkit/bb.edn panas.reload

What each project directory is

babashka-httpkit is an example project that:

• uses sakuracss
• contains all 23 examples featured in htmx website
• contains mermaid.js example

babaskka-file-server is an example project that extend babashka/http-server to serve static files with live reload. You can also uses the bbin alternative to serve static files

Why not Hiccup?

Hiccup is one of HTML data representation in Clojure. I think almost everwhere where there is html and Clojure together, hiccup is the one that is used. However, the reason why this project does not use it because:

• when I first started this to learn htmx, I was still also a newbie at Clojure (barely around 3 months of using it). I knew about Hiccup but I still didn't know well about tooling around clojure and hiccup, so it was a hassle to convert htmx examples from html to hiccup (but eventually I found one of the Calva's feature that helps this tremendously).
• I need VSCode's features working with html such as code completion and everything that helps writing JavaScript in html. I also need tailwind plugin niceties in html since another clojure+htmx project of mine uses tailwind so the habit of using html was shared between these two project (thought later I managed to make tailwind plugin works with hiccup as well).

So, currently I know more about dealing with hiccup and probably will use more hiccup in my projects. I want to convert babashka-httpkit to using hiccup as well in the future, but leaving the one using html intact. I had received some advice that in some projects that might involve non-clojure people, using html might makes more sense because html is more familiar and more supported in terms of tooling. So, there will be two identical project but one uses html and the other uses hiccup.