Root route in Ruby on Rails

Introduction

The root route tells your Rails app what page to show first when someone visits your website's main address.

When you want to set the homepage of your website.

When you want visitors to see a welcome or dashboard page first.

When you want to direct users to a landing page after login.

When you want to organize navigation starting from a main page.

When you want to avoid errors from no default page set.

Syntax

Ruby on Rails

root 'controller_name#action_name'

Replace controller_name with your controller's name (usually plural).

Replace action_name with the method that renders the page (like index or home).

Examples

This sets the homepage to the index action in the WelcomeController.

Ruby on Rails

root 'welcome#index'

This sets the homepage to the home action in the DashboardController.

Ruby on Rails

root 'dashboard#home'

Sample Program

This example sets the root route to the home action in PagesController. When you visit the main URL, it shows a plain text welcome message.

Ruby on Rails

# config/routes.rb
Rails.application.routes.draw do
  root 'pages#home'
end

# app/controllers/pages_controller.rb
class PagesController < ApplicationController
  def home
    render plain: "Welcome to the Home Page!"
  end
end

Important Notes

Only one root route should be set in your routes file.

If you don't set a root route, visiting the main URL will cause an error.

You can check your root route by running rails routes in the terminal.

Summary

The root route sets the default page for your website.

It uses the syntax root 'controller#action'.

Setting a root route helps visitors see a starting page without errors.

Practice

1. What does the root route do in a Rails application?

easy

A. It specifies the layout template for all pages.

B. It defines a new database table for the app.

C. It creates a new controller automatically.

D. It sets the default page visitors see at the website's base URL.

Solution

1. Step 1: Understand the purpose of root route

   The root route defines what page loads when someone visits the main URL of the website.

2. Step 2: Identify what root route sets

   It sets the default controller action to show, so visitors see a starting page without errors.

3. Final Answer:

   It sets the default page visitors see at the website's base URL. -> Option D

4. Quick Check:

   Root route = default homepage [OK]

Hint: Root route sets homepage URL view [OK]

Common Mistakes:

• Confusing root route with database or controller creation
• Thinking root route sets layout or styles
• Assuming root route is optional for homepage

2. Which of the following is the correct syntax to set the root route to the home action in the pages controller?

easy

A. root 'pages#home'

B. root to: 'pages#home'

C. root pages#home

D. root => 'pages#home'

Solution

1. Step 1: Recall root route syntax

   The standard syntax is root 'controller#action' without extra keywords.

2. Step 2: Check each option

   root 'pages#home' matches the correct syntax exactly. root to: 'pages#home' adds unnecessary to:, C misses quotes, D uses old hash rocket syntax incorrectly.

3. Final Answer:

   root 'pages#home' -> Option A

4. Quick Check:

   Syntax = root 'controller#action' [OK]

Hint: Use quotes and # between controller and action [OK]

Common Mistakes:

• Adding extra keywords like 'to:' incorrectly
• Omitting quotes around controller#action
• Using old hash rocket syntax in modern Rails

3. Given this routes file snippet:

Rails.application.routes.draw do
  root 'welcome#index'
  get 'about', to: 'pages#about'
end

What happens when a user visits http://localhost:3000/?

medium

A. The browser redirects to /about automatically.

B. The pages#about action runs and its view is shown.

C. The welcome#index action runs and its view is shown.

D. A routing error occurs because root is not set.

Solution

1. Step 1: Identify root route action

   The root route is set to welcome#index, so visiting '/' triggers this action.

2. Step 2: Understand other routes

   The /about path goes to pages#about, but it is not the root URL.

3. Final Answer:

   The welcome#index action runs and its view is shown. -> Option C

4. Quick Check:

   Root URL = welcome#index [OK]

Hint: Root route controls '/' URL behavior [OK]

Common Mistakes:

• Confusing root route with other get routes
• Expecting automatic redirects without code
• Assuming missing root causes errors

4. You wrote this in config/routes.rb:

root 'main#home'
root 'dashboard#index'

What is the problem with this code?

medium

A. The syntax is wrong; root needs a block, not a string.

B. You cannot define more than one root route; it causes a conflict.

C. The controller names must be capitalized.

D. This code will work fine and set the root to the last line.

Solution

1. Step 1: Check root route rules

   Rails allows only one root route. Defining multiple causes conflicts or errors.

2. Step 2: Analyze given code

   Two root routes are defined, which is invalid and will cause routing errors.

3. Final Answer:

   You cannot define more than one root route; it causes a conflict. -> Option B

4. Quick Check:

   Only one root route allowed [OK]

Hint: Only one root route per app allowed [OK]

Common Mistakes:

• Thinking last root route overrides previous silently
• Confusing root route syntax with controller naming
• Believing multiple root routes are valid

5. You want your Rails app to show the landing page from the home controller as the root route, but only if the user is not logged in. Otherwise, it should show dashboard#index. How can you set this up?

hard

A. Set root to a controller action that redirects based on login status.

B. Define two root routes with conditions in routes.rb.

C. Use root 'home#landing' and add a before_action in dashboard.

D. Set root to dashboard#index and ignore login status.

Solution

1. Step 1: Understand root route limitation

   Rails allows only one root route, so conditional logic must be inside the controller.

2. Step 2: Implement conditional redirect

   Set root to a controller action (e.g., home#root_redirect) that checks login and redirects accordingly.

3. Final Answer:

   Set root to a controller action that redirects based on login status. -> Option A

4. Quick Check:

   Use controller logic for conditional root [OK]

Hint: Use controller action to redirect root conditionally [OK]

Common Mistakes:

• Trying to set multiple root routes with conditions
• Ignoring login status in root route setup
• Assuming routes.rb supports conditional root directly