AdamFrey / clojure-html-server-live-reload-template

Template for setting up automatic reload for Clojure server-rendered HTML.

Clojure Live Reload HTML Server Template

Automatic browser live reload for Clojure server rendered HTML. A Figwheel/shadow style experience, but without ClojureScript.

Note that this functionality can also be achieved with the ring-refresh library which I wasn't aware of when I first published this project. See note in alternatives.

This template will generate a starting-point project for a clojure server that serves Hiccup-based HTML and CSS with live reload functionality. Your browser tab will reload automatically when you re-evaluate the namespaces with your hiccup clojure code and when your CSS files are saved.

See introductory blog post for more information.

Usage

This is a template project for use with deps-new.

To use it, first make sure you have installed deps-new as your new "tool" via:

clojure -Ttools install io.github.seancorfield/deps-new '{:git/tag "v0.4.13"}' :as new

Then replace yourcorp/app-name with your desired application name and run:

    $ clojure -Sdeps '{:deps {io.github.adamfrey/clojure-html-server-live-reload-template {:git/sha "4bc908f5d601e2ba24c477f7bc123e83f89635a3"}}}' -Tnew create :template afrey/html_server_live_reload_template :name yourcorp/app-name

Next, open up the README.md file in the newly created project for more information on usage.

Alternatives

• ring-refresh - has been around for much longer than this project and is quite arguably a more elegant middleware-based approach to the problem. ring-refresh uses timeouts instead of websockets for reload notifications.
• panas.reload appears to aim for a similar goal, uses babashka

License

Copyright © 2023 Adam Frey

Distributed under the Eclipse Public License version 1.0.