Root route in Ruby on Rails - Mini Project: Build & Apply

Setting a Root Route in Rails

📖 Scenario: You are building a simple Rails web application for a local bookstore. You want visitors to see a welcome page when they visit the main website address.

🎯 Goal: Set up a root route in Rails so that the homepage shows the home#index action when users visit the base URL.

📋 What You'll Learn

Create a controller named home with an index action

Add a root route in config/routes.rb pointing to home#index

Ensure the root route is the first route defined

Use Rails routing syntax correctly

💡 Why This Matters

🌍 Real World

Setting a root route is essential for any Rails website to define what users see first when they visit the site.

💼 Career

Understanding routing and root routes is a fundamental skill for Rails developers working on web applications.

1

Create the Home Controller with Index Action

Create a controller named home_controller.rb inside app/controllers with a class HomeController that has an empty method index.

Ruby on Rails

# Your code here to create HomeController with index action

Hint

Use class HomeController < ApplicationController and define def index inside it.

2

Open the Routes File

Open the config/routes.rb file to prepare for adding the root route.

Ruby on Rails

# Open config/routes.rb to add root route

Hint

Make sure you have Rails.application.routes.draw do and end in config/routes.rb.

3

Add the Root Route

Inside Rails.application.routes.draw do, add the root route using root 'home#index' to point the base URL to the index action of HomeController.

Ruby on Rails

Rails.application.routes.draw do
  # Add root route here
end

Hint

Use root 'home#index' inside the routes block.

4

Verify the Root Route Placement

Ensure the root route root 'home#index' is the first route inside the Rails.application.routes.draw do block in config/routes.rb.

Ruby on Rails

Rails.application.routes.draw do
  # Confirm root route is first
  root 'home#index'
end

Hint

The root route should be the first line inside the routes block.

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