Rails v8.1 Development Guide

Reference documentation based on the official Rails Guides v8.1.1, organized by topic. Each reference file has a table of contents. Consult the relevant file when working on specific Rails components.

Reference Navigation

Active Record

Split across 4 files by topic:

• active_record_basics.md (5,800 lines) — Models, CRUD, naming conventions, migrations, validations, callbacks
• active_record_queries.md (2,700 lines) — Query interface, conditions, ordering, joins, eager loading, scopes, calculations
• active_record_associations.md (3,400 lines) — Association types, configuration, STI, delegated types, reference
• active_record_advanced.md (4,100 lines) — Active Model, PostgreSQL features, multiple databases, composite primary keys, encryption

Controllers & Views

• controllers.md (1,900 lines) — Action Controller basics, strong params, cookies, sessions, callbacks, CSRF, HTTP auth, streaming, error handling
• views.md (4,800 lines) — Action View, templates, partials, layouts, view helpers, form helpers, rendering

Configuration & Internals

• configuration.md (4,750 lines) — Rails config options, versioned defaults, environment settings, initializers, load hooks, initialization process
• internals_autoloading.md (915 lines) — Zeitwerk autoloading, reloading, eager loading, threading, concurrency
• internals_engines_cli.md (3,920 lines) — Rack middleware, Rails engines, CLI tools, custom generators

Other References

• testing_debugging.md (3,700 lines) — Unit/integration/system tests, fixtures, debugging
• jobs_mailers_cable.md (3,650 lines) — Active Job, Action Mailer, Action Mailbox, Action Cable
• i18n_support.md (5,700 lines) — I18n, locale files, Active Support core extensions, instrumentation
• storage_caching.md (2,450 lines) — Active Storage file uploads, caching strategies
• security_performance.md (2,270 lines) — XSS, CSRF, SQL injection prevention, performance tuning
• assets_frontend.md (2,080 lines) — Asset pipeline, JavaScript bundling, CSS, Action Text
• routing.md (1,380 lines) — RESTful routing, nested routes, constraints, concerns
• api_development.md (585 lines) — API-only apps, serialization, authentication, versioning, CORS

Version Notes

Rails 8.1.1 key features:

• Solid Queue, Solid Cache, Solid Cable for built-in infrastructure
• Enhanced Turbo integration
• Improved authentication generators
• Progressive Web App features