Skip to content

[mirror] A sustainable architecture for Ruby on Rails by Shopify

Notifications You must be signed in to change notification settings

backpackerhh/upgrow-docs

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 

Repository files navigation

Note

The website https://upgrow.shopify.io was taken down for some reason. You can access it through the archive.org at https://web.archive.org/web/20210304183319/https://upgrow.shopify.io/

Upgrow

Ruby on Rails is the framework of choice for web apps at Shopify. It is an opinionated stack for quick and easy development of apps that need standard persistence with relational databases, an HTTP server, and HTML views.

By design, Rails does not define conventions for structuring business logic and domain-specific code, leaving developers to define their own architecture and best practices for a sustainable codebase.

In fast product development teams, budgets and deadlines interfere with this architectural work, leading to poorly written business logic and complicated code that is very hard to maintain long term. Even when developer teams take the time to think about what a good architecture in Rails look like, this work is likely required to be done all over again when a new Rails app needs to be created.

This project aims to make it easier for both new and existing Rails apps to adopt patterns that are proven to make code more sustainable long term, and codebases easier to maintain and extend. We will recommend a set of abstractions and practices that are simple, yet powerful in organizing code in Rails apps in a way that allows fast-growing apps to remain easy to change.

Guide

  1. Introduction
  2. The Goal of Good Software Design
  3. Code Smells in Rails Apps
  4. Software Design Principles
  5. A Better Architecture
  6. The Missing Pieces
  7. Extensions
  8. Caveats
  9. Final Words

About

[mirror] A sustainable architecture for Ruby on Rails by Shopify

Resources

Stars

Watchers

Forks