A website template for Common Lisp
Start building an app quickly.
- Hunchentoot, Easy-routes
- Djula templates
- a welcome screen
- a form to search products ("product 1"…)
- a list of products
- run as a script or build a binary.
Uses Bulma CSS and used Bulma templates examples.
See also our cl-cookieweb project generator.
Welcome screen:
Searching products:
How to run the app
There are two possibilities to run the app from the command line:
rlwrap sbcl --load run.lisp
In that case, we are dropped into the Lisp REPL, so we can interact with the running application. It is specially useful to reload settings (contact information,…).
Or build the binary and run it:
make build
./myproject
Set the port:
PORT=9999 rlwrap sbcl --load run.lisp
Config file
You can use a starter configuration file:
touch ~/.myproject.lisp
In there, you can do anything in Lisp. You probably want to write things after (in-package myproject), but that is not mandatory. For example, you can overwrite the get-products function.
The file will be load'ed at startup, in the context of the myproject package.
Develop
Load myproject.asd (C-c C-k in Slime), (ql:quickload :myproject) and then (start).
TODO:
- load static files => use the regular
(hunchentoot:create-folder-dispatcher-and-handler #p"/path/to/static/"). - anything more useful for a web app
See also:
- the real world app from where I extracted this template (it reads a DB, it has a shopping basket and a validation form that sends an email to the owner).
- my preliminary notes on live-reloading a lisp web app: https://github.com/vindarel/lisp-web-live-reload-example
- how to connect to a remote running image with a Swank server: https://lispcookbook.github.io/cl-cookbook/debugging.html#remote-debugging
- https://lispcookbook.github.io/cl-cookbook/web.html
- https://github.com/CodyReichert/awesome-cl#web-frameworks
Licence
WTFPL