Rails Routing Cheatsheet

The Rails router recognizes URLs and dispatches them to a controller's action, while generating reciprocal paths and URLs through helpers.

Resourceful Routes (resources)

Rails.application.routes.draw do
  root "home#index"

  resources :articles do
    # Member routes (operates on specific item /articles/:id/publish)
    member do
      patch :publish
    end

    # Collection routes (operates on /articles/search)
    collection do
      get :search
    end

    # Nested resources (/articles/:article_id/comments)
    resources :comments, only: [:create, :destroy]
  end
end

---

Route Path Helpers

---

Namespaces & Scopes

# Namespace: prefix URL with /admin and controllers with Admin::
namespace :admin do
  resources :users
end
# Routes to Admin::UsersController at /admin/users

# Scope: prefix URL without modifying controller namespace
scope "/v1" do
  resources :posts
end

---

Custom Singular Routes & Redirects

# Custom verb mapping
get '/about', to: 'pages#about'
post '/webhook', to: 'webhooks#receive'

# 301 Permanent Redirect
get '/stories', to: redirect('/articles')

---

References

• Rails Routing from the Outside In Guide
• Rails Overview Cheatsheet