zoom_in Click to enlarge

Hanami

▲ ▼

language

description Hanami Overview

Hanami is an open-source Ruby web framework, originally released under the name "Lotus" in 2014 and renamed in 2016. It is built on top of Rack and emphasizes a modular, object-oriented architecture with strict separation between actions, views, models, and repositories. The framework includes its own ORM, templating system, and testing utilities, and uses explicit conventions rather than the implicit "magic" associated with Ruby on Rails. Hanami is designed for Ruby developers who prefer a more structured, testable approach to web application development.

help Hanami FAQ

Why was the Ruby framework Lotus renamed Hanami?

The project launched under the name Lotus in 2014 but hit trademark conflicts with established uses of the Lotus name, so it was renamed Hanami in 2016. The rename applied across the framework's gems and ecosystem.

When was Hanami 2.0 released and is it production-ready?

Hanami 2.0 shipped in November 2022 as a major rewrite emphasizing a modular core and 'slices' for structuring apps. Subsequent releases added back the persistence and view layers that early 2.x lacked, with the database layer arriving around early 2025 in the 2.x line.

How is Hanami different from Rails?

Hanami enforces strict separation between actions, views, models, and repositories on top of Rack, rather than Rails' convention-over-configuration monolith. That makes it appealing to teams who want an explicitly layered Ruby architecture with a lighter footprint.

Can Hanami be used with existing Ruby libraries and Rack middleware?

Yes, Hanami is built directly on Rack, so standard Rack middleware works, and it interoperates with the wider Ruby gem ecosystem. Hanami 2's design lets you compose your own stack rather than inheriting a fixed full-stack default.

swap_horiz

Looking for Hanami alternatives? Compare top competitors ranked & scored

arrow_forward