Skip to content

Introduction

Bruno Dias edited this page May 10, 2026 · 1 revision

io.github.cl-sdk.wst provides tools to help build web applications in Common Lisp.

The project is intended to offer practical building blocks for web development rather than forcing a single rigid application structure. It focuses on making it easier to define application behavior, organize request handling, and compose reusable web-related features.

Goals

The main goals of the project are:

  • provide a simple foundation for building web applications in Common Lisp
  • support modular application design
  • make common web concerns easier to manage
  • keep application code expressive and idiomatic

What this project includes

Depending on how your application uses the library, the framework may help with areas such as:

  • routing requests to handlers
  • session management
  • resilience features such as circuit breakers
  • organizing web application components
  • supporting reusable feature modules

Intended audience

This project is intended for Common Lisp developers who want:

  • a lightweight toolkit for web applications
  • reusable abstractions for server-side development
  • a foundation they can adapt to their own architecture

How to read this wiki

If you are new to the project, start here and then continue with:

  1. Routing for request dispatch and handler organization
  2. Features for optional or reusable application capabilities
  3. specific feature pages such as Circuit breaker and Session

Project philosophy

The framework is best understood as a set of composable tools. Instead of hiding application behavior behind too much convention, it aims to expose useful primitives that developers can combine in a way that matches their application needs.

As you read the rest of the wiki, keep in mind that the exact integration style may vary depending on how the library is embedded in your application.

Clone this wiki locally