Recourse

Recourse Guides

What each screen does and why it does it that way, one page per screen. The reference says what every method takes; these say what to write and what you get.

Start here

Getting startedInstall the gem, route a resource, secure the controllers, and see what each action earns. Routesrecourses and recourse, nesting and namespaces, the defaults a nested resource takes, and the two keywords. ModelsThe hooks a model may answer — label, hidden, displayed, order, icon — and everything the schema says without them.

The screens

TablesWhich columns a table draws and in what order, sorting, searching, filters, pages, bookmarks, counters and live refreshes. Records and formsHow a value reads on a record’s page, which field each column gets on a form, the card around both, and the delete. Maps and calendarsThe same page of rows drawn on a Google map, or as a week of events. Positionable tablesRows dragged into an order the model keeps, and what keeps the numbers running. Retrievable tablesA table whose rows come from somewhere else, and the button that fetches them again.

The host’s side

Look and feelColor and theme, what the reader chooses for themselves, where the assets come from, and the locale. CustomizingViews and controllers a host writes in place of what the gem draws, and what stays the gem’s.