RailsRevelry is a Ruby on Rails internals publication for developers who can build Rails apps but want a better grasp of what the framework does under the hood.

Rails is friendly on purpose. You can ship a lot before you understand the path a request takes through the system.

That is useful until something breaks in a place your controller code does not explain:

  • a request never reaches the action you expected

  • middleware changes the request or response before you see it

  • routing picks a different endpoint than the one you had in mind

  • params contains a value from the wrong place

  • a callback runs before the line of code you are reading

  • a performance problem starts outside the obvious application code

RailsRevelry follows those moments down into the framework.

The publication explains Rails as an execution system: how requests cross framework layers, how state and identity move between requests, and how Ruby intent eventually becomes persistent database state.

The goal is not to memorize Rails source code, but to know where behavior comes from, which layer owns it, and what to inspect when production Rails does something surprising.

What This Covers

RailsRevelry focuses on the parts of Rails that shape runtime behavior:

  • request lifecycle

  • Rack and the Rails middleware stack

  • routing internals

  • controller dispatch

  • callbacks and filters

  • parmas parsing and merging

  • rendering and response flow

  • sessions, flash, and request identity

  • Active Record queries, and object lifecycles

  • transactions and commit boundaries

  • debugging across framework boundaries

  • performance trade-offs caused by framework structure

Some posts are conceptual. Some get closer to Rails internals such as ActionDispatch, ActionController, Active Record, Rack, route recognition, and callback chains. The point is always the same: make the behavior easier to reason about in a real application.

Who This Is For

This is for Rails developers who:

  • can already build Rails applications

  • have debugged enough Rails code to know the framework is not magic

  • want stronger models for request flow, state, identity, persistence, and framework ownership

  • care about production behavior, not just tutorial examples

If you are brand new to Rails, this may be a little below the surface.

If you have built Rails apps long enough to be annoyed by “it just works”, you are probably in the right place.

How the Publication Is Organized

RailsRevelry is written as a sequence of chapters:

  • Chapter 1: The Request Boundary follows a request through Rack, middleware, routing, controller dispatch, params, callbacks, responses, and rendering.

  • Chapter 2: State, Identity, and the Space Between Requests examines sessions, flash, authentication, and the lifecycle of current_user.

  • Chapter 3: The Persistence Boundary traces deferred queries, in-memory model state, transactions, and committed database truth.

Each article stands on its own, but the chapters build a larger map of Rails runtime behavior.

Start here for the complete chapter map and recommended reading paths.

About Me

I am Syed Aslam, a software engineer with 15+ years of experience building and maintaining Rails applications.

I write RailsRevelry because most Rails explanations stop at the layer where application code begins. The interesting debugging work often starts one layer earlier.

To understand Ruby on Rails inside out!

User's avatar

Subscribe to Rails Revelry

RailsRevelry explains Rails as an execution system: how requests flow, how framework boundaries work, and why Rails behaves the way it does.

People