The Clojure Web Developer's Toolkit: A Framework Face-off

Clojure excels in handling concurrency, which is crucial for scalable web applications. It offers a REPL-driven development experience for rapid prototyping. Clojure's expressive syntax, powerful macro system, and seamless interoperability with JavaScript through ClojureScript make it a compelling choice for modern web development projects. These advantages, coupled with an active community and rich ecosystem of web-specific tools, make Clojure a compelling choice.

Clojure empowers developers to build efficient, maintainable, and full-stack web applications. Whether you're looking to build scalable web services, manage application states effectively, or create rich interactive user interfaces, Clojure has everything to suit your project requirements.

What is a framework?

A web framework is a collection of libraries and tools bound together to provide a structured, templated approach to building web applications. It serves as a foundation that simplifies and streamlines the development process by offering pre-built components and a standardized project structure.

Key aspects of web frameworks include:

Architecture

Frameworks often enforse or suggest a particular architectural pattern (e.g. MVC, MVVM) to organize code and separate concerns.

Abstraction

They abstract away common low-level details, allowing developers to focus on application-specific logic.

Conventions

Many frameworks follow the "convention over configuration" principle, providing sensible defaults that can be customized.

Tooling

Frameworks typically come with CLI tools, build systems, and development servers to enhance productivity.

Security

Built-in security features and best practices help developers create more secure applications.

Scalability

Frameworks often include mechanisms for handling increased load and growing codebases.

Web frameworks provide several benefits and potential drawbacks:

In the Clojure ecosystem, web frameworks range from full-featured solutions to more minimalist, composable tools. They leverage Clojure's functional programming paradigm and Java interoperability to provide robust, scalable foundations for web development.

Let's explore some popular web frameworks in Clojure's ecosystem, examining their features, strengths, and use cases.

01. Luminus

Luminus is a full-featured micro-framework designed for web applications. It aims to provide a robust foundation for developing web services and applications by integrating libraries and tools that work well together. Luminus focuses on ease of use and modularity. Upon project initialization, it provides a fully functional web stack. This comprehensive foundation serves as a starting point, which you can then build upon or customize according to your specific requirements and preferences [1].

Luminus has comprehensive documentation, so you won't be overwhelmed by the number of libraries included. There are guides and example projects for beginners, and there is even a book that documents the recommended approach to Luminus.

Luminus is best suited for:

Medium to large-scale web applications

Projects requiring a full-featured, batteries-included approach

Teams that value extensive documentation and community support

Applications needing robust security features out of the box

Developers looking for a well-structured starting point for complex web services

02. Kit

Kit is a relatively new framework that builds on the lessons learned from Luminus and should be considered a modern alternative [2]. It emphasizes a highly modular approach and provides comprehensive documentation and examples for building on it.

Both Kit and Luminus allow you to integrate a broad range of libraries into your web application projects. However, Kit offers enhanced modularity compared to Luminus. This key difference means that with Kit, you have greater flexibility to incorporate new libraries into your project at any stage of development. Unlike Luminus, where you might need to select all libraries at the outset, Kit allows for easier expansion and modification of your project's dependencies as your needs evolve.

Kit is ideal for developers who want a lightweight, flexible framework for building modern web applications and microservices without being tied down by unnecessary complexity.

Kit is best suited for:

Developers who prefer a modular, composable approach

Startups and projects that may need to pivot or change requirements frequently

Microservices architecture where lightweight, flexible components are crucial

Teams that want to gradually add complexity as the project grows

Projects that require easy integration with various Clojure libraries

03. Pedestal

Pedestal is a set of libraries designed to build web applications and services in Clojure. It emphasizes immutability, simplicity, and composability, following Clojure's core principles. Pedestal offers built-in support for asynchronous request handling and flexible routing capabilities that allow for fine control over request handling. Its interceptor mechanism, similar to middleware, modularizes logic around request processing. Pedestal also includes out-of-the-box support for WebSockets, enabling real-time communication, and is optimized for efficiently handling large traffic volumes.

Pedestal has an active community. However, the documentation is not great, and there aren't many project examples to start with.

‍Pedestalis best suited for:

High-performance, scalable web services

Applications requiring fine-grained control over request handling

Projects with complex routing needs

Real-time applications leveraging WebSockets

Teams with strong functional programming experience

Services that need to handle high volumes of concurrent requests efficiently

Creating a custom framework

Frameworks enforce a particular model of the world and an accompanying set of restrictions and libraries on you. You can start from scratch and choose your stack if you feel overwhelmed. Composing libraries together is usually not that hard, but it requires you to leave the comfort zone of the framework's abstractions to try to understand what is happening. But you have much more freedom this way.

For example, you can take Ring as a server (which all of the above-mentioned frameworks use), reitit for routing, reagent for your React components, re-frame for reactive programming and state management, malli for data validation, etc. You can find more library options here.

It could be hard to make such decisions, but switching libraries is relatively easy if one doesn't work for you. In most cases, libraries that fill the same role are compatible.

You'll probably end up with something similar to what you would if you chose a framework anyway, but this way, you'll have much more control and understanding of your project.

Conclusion

The Clojure ecosystem offers a range of powerful frameworks and libraries that cater to various development needs, from web applications to state management, front-end development, and microservices. However, every solution has its caveats. Clojure's ecosystem is rich and modular, so you'll always find the best solution to your problem.

‍