rails-style

What problem does it solve?

Rails teams often struggle with inconsistent code style, making it harder to read, review, and maintain large Rails apps. This guide provides opinionated conventions for conditionals, method ordering, visibility, bang methods, and naming to improve readability and maintainability across models, controllers, and concerns.

Core Features & Use Cases

• Expanded conditionals over guard clauses (except early returns) to improve clarity.
• Clear method ordering by invocation flow and proper visibility modifiers to reduce cognitive load.
• Guidelines for bang vs non-bang method usage, intention-revealing names, and resource-oriented controller patterns.
• Useful during code reviews, onboarding, and refactoring to enforce consistent Rails conventions.

Quick Start

Integrate these conventions into your Rails project by importing the rails-style guide and applying its rules to your models and controllers.