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 Book, fieldset: :index %> <%# filter sidebar (takes the model, not a scope) %>Read more: Fields & cells · Views & fieldsets
| Cover | Title | Author names | Genre | Price | Publisher | Active | ||
|---|---|---|---|---|---|---|---|---|
|
|
||||||||
 |
The Hidden Forest 1 | Frank Herbert, Ted Chiang, and Ann Leckie | Nonfiction | 28.24 € | Orbit | ✗ | ||
 |
The Dispossessed Winter 24 | Ted Chiang | Nonfiction | 19.40 € | Del Rey | ✗ | ||
 |
The Broken Ocean 68 | Kim Robinson and Stanisław Lem | Nonfiction | 6.07 € | Tor Books | ✗ | ||
 |
The Quiet Dune 76 | Mary Shelley | Nonfiction | 24.14 € | Vintage | ✗ | ||
 |
The Distant Engine 80 | Joe Abercrombie, Iain Banks, and Ann Leckie | Nonfiction | 43.18 € | Del Rey | ✗ | ||
 |
The Endless Winter 84 | Iain Banks | Nonfiction | 34.31 € | Vintage | ✗ | ||
 |
The Luminous Tower 89 | Joe Abercrombie, Liu Cixin, and Margaret Atwood | Nonfiction | 22.68 € | Ace | ✗ | ||
 |
The Silent Dune 107 | Stanisław Lem and Octavia Butler | Nonfiction | 17.86 € | Vintage | ✗ | ||