http://cjackson.tk/todo-tutorial
Overview: https://github.com/interactive-ssr/client/blob/master/main.org
What makes ISSR unique is its lack of any kind of client-side programming. Other Server based frameworks allow you write what would normally be written in Javascript onto the server. ISSR goes a step further into the land of declarative programming by moving any interactive changes into the realm of HTML generation (rather than DOM manipulation). The web developer only needs to know HTML and the server-side programming language (and CSS if you want styles); No knowledge about Javascript or DOM is necessary.
ISSR is websockets oriented: if two clients share the same connection and the same session, they view each other's actions at the same time (see the Backgammon tutorial).
I did the todo-app again, but with Djula templates (Django-like templates, although more flexible, it's Lisp).
It's time to envision serious things with this library.
This is interactive just as we expect:
missing:
- websockets illustration
With Roswell (experimental):
ros install vindarel/issr-todolist
On the terminal:
make run
# aka
sbcl --load issr-test.asd --eval '(ql:quickload :issr-test)' --eval '(issr-test:main)'
paramaters: ISSR_PORT
and ISSR_WS_PORT
.
Manually (Slime):
- load issr-test.asd (C-c C-k)
- (ql:quickload "issr-test")
- (issr-test:main :port xxx :ws-port xyz)
Access http://localhost:8080/products
You also get a Lisp REPL on the terminal from which you can interact with the running web app.
Build a binary with Roswell:
ros build roswell/issr-test.ros
this builds a binary in the roswell/ directory. You can run it directly.
warn: Roswell doesn't use the same Quicklisp directory as yours but its own, so you maybe don't have the package versions on Slime and with Roswell (unless your editor is set up to use Roswell).
It is when we ros install foo
that we can run ros exec foo
.
- We can't update little parts of the DOM. That is not the philosophy of ISSR. To be more precise:
You can update small parts on the client, but the whole thing is still generated on server, then only small changes are sent to the client.
- How to add transitions on added elements? It seems difficult (it's possible in JS. htmx has workarounds for this).
-
https://htmx.org/ - similar in scope. We can update precise parts of the DOM, built-in transitions support… Websockets support is "experimental", whereas it is the primary focus of ISSR.
Other demos:
- on live-reloading a running web app thanks to the REPL: https://lisp-journey.gitlab.io/blog/i-realized-that-to-live-reload-my-web-app-is-easy-and-convenient/ (-> https://github.com/vindarel/lisp-web-live-reload-example)
The very best part of image-based programming in action.
:]