V1.3: Generators

Hanami has convenient code generators to speed up our development process.


With Hanami architecture, we can have multiple Hanami applications running under apps/. The default application is called Web and lives under apps/web.

We can generate new applications for different components that we want to add to our project.

$ bundle exec hanami generate app admin

This generates an application named Admin under apps/admin.


Generate an action along with the corresponding view, template, route and test code with one command.

$ bundle exec hanami generate action web books#show

This generates the action Web::Controllers::Books::Show.

The first argument, web, is the name of the target application in a Hanami project.

The argument books#show is the name of the controller and the action separated by the number sign (#).

For nested actions, use a slash (/) to separate the modules. Nested actions work in conjunction with nested resourceful routes. For example:

$ bundle exec hanami generate action web books/editions#show

This generates the action Web::Controllers::Books::Editions::Show.

If you wish to generate only the action, without the view and template, you can do that by using the --skip-view.

$ bundle exec hanami generate action web books#show --skip-view

If you wish to generate an action with a specific method, you can do that by using the --method.

$ bundle exec hanami generate action web books#create --method=post


The generated route is named after the controller name.

# apps/web/config/routes.rb
get '/books', to: 'books#show'

If we want to customize the route URL, without editing our routes file, we can specify a --url argument.

$ bundle exec hanami generate action web books#show --url=/books/:id

This will generate the following route:

# apps/web/config/routes.rb
get '/books/:id', to: 'books#show'

The default HTTP method is GET, except for actions named:

Action name HTTP verb
create POST
update PATCH
destroy DELETE

This should help you route using RESTful resources.

You can also set the HTTP method by specifying a --method argument when calling hanami generate action.


Generate an entity and a repository with a single command

$ bundle exec hanami generate model book
      create  lib/bookshelf/entities/book.rb
      create  lib/bookshelf/repositories/book_repository.rb
      create  db/migrations/20170213123250_create_books.rb
      create  spec/bookshelf/entities/book_spec.rb
      create  spec/bookshelf/repositories/book_repository_spec.rb

It generates an entity with the corresponding repository, migration, and tests.

The migration will already contain the code for the creation of the table, the primary key and the timestamps:

# db/migrations/20170213123250_create_books.rb
Hanami::Model.migration do
  change do
    create_table :books do
      primary_key :id

      column :created_at, DateTime, null: false
      column :updated_at, DateTime, null: false


Generate a database migration

$ bundle exec hanami generate migration create_books
      create  db/migrations/20161112113203_create_books.rb

It generates an empty migration with the UTC timestamp and the name we have specified: db/migrations/20161112113203_create_books.rb.


Generate a mailer

$ bundle exec hanami generate mailer welcome

It creates the following files:

$ tree lib/
├── bookshelf
│   # ...
│   ├── mailers
│   │   ├── templates
│   │   │   ├── welcome.html.erb
│   │   │   └── welcome.txt.erb
│   │   └── welcome.rb # Mailers::Welcome
# ...


Generate a HTTP sessions secret for an application.

$ bundle exec hanami generate secret web
Set the following environment variable to provide the secret token: