How this page is built
the gem renders it — this is all you write
A full table — search, an inline filter row, sortable columns and row actions — all derived from the model. This page toggles between the curated :index and the fuller :catalog fieldset (currently :index). Your controller assigns @books — scope it for authorization (e.g. Book.accessible_by(current_ability)) and the gem renders that scope.
app/models/book.rb
crud_structure do
attribute :price, as: :number, unit: '€', digits: 2
fieldset :index, %i[cover title author_names genre price publisher active]
fieldset :catalog, %i[cover title subtitle author_names genre price purchase_price
shop_margin pages published_on publisher reviews active manual created_at]
end
app/views/books/index.html.erb
<%= crud_collection @books, fieldset: :index %> <%# search, filters, sort, actions %>
<%= crud_filter @books, fieldset: :index %> <%# filter sidebar (the model, or the list's scope) %>
Read more: Fields & cells · Views & fieldsets
| Cover | Title | Author names | Genre | Price | Publisher | Active | ||
|---|---|---|---|---|---|---|---|---|
|
|
|
|||||||
![]() |
The Broken Mirror 37 | Margaret Atwood and Octavia Butler | Nonfiction | 7.28 € | Tor Books | ✓ | ||
![]() |
The Ancient Machine 51 | Ann Leckie and Ursula Le Guin | Nonfiction | 40.77 € | Tor Books | ✓ | ||
![]() |
The Quiet Tower 90 | Octavia Butler, Ted Chiang, and Margaret Atwood | Nonfiction | 31.01 € | Tor Books | ✓ | ||


