CSS bundling options in Ruby on Rails - Mini Project: Build & Apply

CSS Bundling Options in Rails

📖 Scenario: You are building a simple Rails web app that needs styling. You want to organize your CSS files efficiently using Rails CSS bundling options.

🎯 Goal: Create a basic Rails CSS setup using CSS bundling with Tailwind CSS. You will set up the CSS file, configure bundling, and include the styles in your application layout.

📋 What You'll Learn

Create a CSS file named application.tailwind.css with Tailwind directives

Add gem "cssbundling-rails", group: :development to your Gemfile

Use the cssbundling-rails gem to install Tailwind CSS

Include the bundled CSS in the application layout file app/views/layouts/application.html.erb

💡 Why This Matters

🌍 Real World

Organizing CSS with bundling helps keep styles efficient and maintainable in Rails web apps.

💼 Career

Understanding CSS bundling in Rails is important for frontend styling and performance optimization in professional Rails development.

1

Create the Tailwind CSS file

Create a CSS file named app/assets/stylesheets/application.tailwind.css with the exact content:
@tailwind base;
@tailwind components;
@tailwind utilities;

Ruby on Rails

# Create the file app/assets/stylesheets/application.tailwind.css
# Add Tailwind CSS directives inside
# Your code here

Hint

These three lines import Tailwind's base styles, components, and utilities.

2

Add cssbundling-rails gem

Add the line gem "cssbundling-rails", group: :development to the Gemfile file to enable CSS bundling for Tailwind CSS.

Ruby on Rails

# Add gem "cssbundling-rails", group: :development to Gemfile
# Your code here

Hint

This gem provides the css:install:tailwind command for bundling.

3

Install Tailwind CSS with cssbundling-rails gem

Run the command bin/rails css:install:tailwind to install Tailwind CSS bundling setup using the cssbundling-rails gem.

Ruby on Rails

# Run the install command in terminal
# Your code here

Hint

This command sets up Tailwind CSS bundling files and configuration.

4

Include bundled CSS in application layout

Add the line = stylesheet_link_tag "application", "data-turbo-track": "reload" inside the <head> tag of app/views/layouts/application.html.erb to load the bundled CSS.

Ruby on Rails

  
  # Your code here

Hint

This tag loads the bundled CSS file into your Rails app layout.

Practice

1. What is the main purpose of CSS bundling in a Rails application?

easy

A. To disable CSS caching in browsers

B. To separate CSS files for easier debugging

C. To convert CSS into JavaScript files

D. To combine multiple CSS files into one for faster page loading

Solution

1. Step 1: Understand CSS bundling concept

   CSS bundling means merging many CSS files into a single file to reduce the number of requests a browser makes.

2. Step 2: Identify the benefit in Rails context

   Combining CSS files speeds up page loading by reducing HTTP requests, which is the main goal of bundling.

3. Final Answer:

   To combine multiple CSS files into one for faster page loading -> Option D

4. Quick Check:

   CSS bundling = faster loading [OK]

Hint: Bundling means merging files to speed up loading [OK]

Common Mistakes:

• Thinking bundling separates files instead of combining
• Confusing CSS bundling with JavaScript bundling
• Assuming bundling disables caching

2. Which command correctly installs Tailwind CSS bundling in a Rails project?

easy

A. rails css:install:tailwind

B. rails css:setup:tailwind

C. rails css:bundle:tailwind

D. rails css:compile:tailwind

Solution

1. Step 1: Recall Rails CSS bundling command pattern

   The correct command pattern is rails css:install:<bundler> to install a CSS bundler.

2. Step 2: Match the bundler name

   For Tailwind CSS, the bundler name is 'tailwind', so the command is rails css:install:tailwind.

3. Final Answer:

   rails css:install:tailwind -> Option A

4. Quick Check:

   Install command = rails css:install:tailwind [OK]

Hint: Use rails css:install:<bundler> for setup [OK]

Common Mistakes:

• Using 'setup' or 'bundle' instead of 'install'
• Typing 'compile' which is not a valid command
• Misspelling 'tailwind'

3. Given the command rails css:install:bootstrap, what is the expected outcome?

medium

A. Rails generates JavaScript files for Bootstrap

B. Bootstrap CSS bundling setup files are added to the project

C. The project removes all CSS files

D. The command throws an error because Bootstrap is unsupported

Solution

1. Step 1: Understand the command purpose

   The command rails css:install:bootstrap installs Bootstrap CSS bundling support in the Rails app.

2. Step 2: Identify the expected effect

   This adds necessary Bootstrap CSS files and configuration to enable bundling, not removing files or generating JS.

3. Final Answer:

   Bootstrap CSS bundling setup files are added to the project -> Option B

4. Quick Check:

   rails css:install:bootstrap adds Bootstrap CSS [OK]

Hint: Install commands add setup files, not remove them [OK]

Common Mistakes:

• Thinking it deletes CSS files
• Expecting JavaScript files instead of CSS
• Assuming Bootstrap bundling is unsupported

4. You run rails css:install:sass but get an error. What is the likely cause?

medium

A. You need to install Node.js first

B. You must run the command with sudo

C. The bundler name should be 'dart-sass', not 'sass'

D. Rails does not support any Sass bundler

Solution

1. Step 1: Check the correct bundler name for Sass

   Rails uses 'dart-sass' as the bundler name, not just 'sass'. Using 'sass' causes an error.

2. Step 2: Verify other options

   Running with sudo is unnecessary, Rails supports Sass via dart-sass, and Node.js is not required for this command.

3. Final Answer:

   The bundler name should be 'dart-sass', not 'sass' -> Option C

4. Quick Check:

   Correct bundler name = dart-sass [OK]

Hint: Use exact bundler names like 'dart-sass' [OK]

Common Mistakes:

• Using partial or incorrect bundler names
• Assuming sudo fixes all errors
• Believing Node.js is required for CSS bundling commands

5. You want to switch from Tailwind to Bootstrap CSS bundling in your Rails app. Which steps should you follow?

hard

A. Remove Tailwind files, run rails css:install:bootstrap, then update your CSS imports

B. Run rails css:install:bootstrap directly without removing Tailwind files

C. Delete all CSS files manually and restart the server

D. Change the bundler name in config files without reinstalling

Solution

1. Step 1: Remove existing Tailwind CSS files

   To avoid conflicts, remove Tailwind CSS files and configurations first.

2. Step 2: Install Bootstrap bundling

   Run rails css:install:bootstrap to add Bootstrap bundling setup.

3. Step 3: Update CSS imports

   Modify your CSS files or imports to use Bootstrap styles instead of Tailwind.

4. Final Answer:

   Remove Tailwind files, run rails css:install:bootstrap, then update your CSS imports -> Option A

5. Quick Check:

   Switch bundlers = remove old + install new + update imports [OK]

Hint: Remove old bundler before installing new one [OK]

Common Mistakes:

• Installing new bundler without removing old files
• Only deleting CSS files without reinstalling bundler
• Changing config without running install commands