The Holy Trinity: Ruby, Bundler, and Gemfiles Explained

If you are coming from JavaScript (npm/yarn) or Python (pip/virtualenv), the Ruby way of doing things can feel slightly different. New developers often run into errors like "Bundler::GemNotFound" or "Your Ruby version is 3.1.2, but your Gemfile specified 3.2.0." To survive as a Rails developer, you need to understand the three distinct layers that keep your application from falling apart. LEVEL 1: The Foundation (.ruby-version) Before you install any libraries, you need the language itself. The problem is that different projects need different versions of Ruby. Old projects might need Ruby 2.7, while your new Rails 8 app needs Ruby 3.3. We solve this with a Version Manager (like rbenv , asdf , mise , or rvm ) and a file called .ruby-version . The File: .ruby-version This file lives in the root of your project and contains a single line: 3.3.0 How it works: When you cd into your project directory, your Version Manager reads this file and silently switches your active Ruby executable to