A Flexible Web Application Environment for Common Lisp

What is Radiance?

Radiance is a web framework for Common Lisp with a focus on allowing you to run multiple applications together. However, it can be just as easily used for any kind of web-focused project.


Radiance offers a number of features to help you develop applications. They're all mostly optional, but they're there to be used if you need them.

Getting Started Developing with Radiance

If you're interested in using Radiance to develop your own applications, you will need a capable Common Lisp implementation and Quicklisp. Installing Radiance requires adding a separate dist to Quicklisp, but remains nonetheless rather straight-forward:

(ql-dist:install-dist "http://dist.shirakumo.org/shirakumo.txt")
(ql:quickload :radiance)

From there on out you can continue by reading through Radiance's documentation or jumping straight in with an in-depth tutorial that walks you through all the steps of creating a fully-fledged web application.

Deploying an Existing Application

If you are instead interested in deploying an existing application that uses Radiance on one of your servers, you can take a short-cut that doesn't require you to set up a development environment. You can use Radiance's automatic bootstrapper to easily create a working setup. All you'll need is a capable Common Lisp implementation.

On Linux using SBCL, starting the installation would look as follows:

curl -O https://raw.githubusercontent.com/Shirakumo/radiance-bootstrap/master/bin/radiance-bootstrap.lisp
sbcl --script radiance-bootstrap.lisp

The bootstrapper will take care of seting up a Radiance distribution for you in a directory of your choice. Once it is done, you can download and extract the source files of the applications you want to use to their own subdirectories in modules/. Then simply run the launcher file mentioned at the end of the bootstrap and you're all set.

You might also want to read Part 7 of the in-depth tutorial, which explains the setup process in a bit more detail.

If you don't know of any applications yet, Shirakumo provides a few open-source ones that you can simply install and use right away: