GitHub – marckohlbrugge/unofficial-37signals-coding-style-guide: Transferable Rails patterns and development philosophy extracted from 37signals' Fizzy codebase

Unofficial 37signals Rails Guide: Transferable Patterns from Fizzy

If you care about writing Rails apps that stay readable, maintainable, and a little bit graceful, this guide is worth a look. I dug into a compact but revealing analysis of 265 pull requests from 37signals‘ Fizzy project, a kanban-style app, and what stands out is not just the code, but *how* decisions evolved over time. You can see the source here: https://github.com/marckohlbrugge/unofficial-37signals-coding-style-guide.

What’s inside, briefly: practical Rails patterns you can copy into your own apps, notes on trade-offs, and the review conversations that shaped each change. They intentionally left out business logic unique to Fizzy, so you get *transferable patterns*, not app-specific quirks. Neat, right?

A couple of important caveats, though. The guide was largely produced by a language model (Claude) analyzing PRs and code snippets, so expect some small inaccuracies, and verify anything you plan to copy. Also, code snippets are under the O’Saasy License, while the guide content itself is MIT-licensed. Read both licenses before reusing things.

How I use this guide: as a mirror when I refactor. I’ll read a PR example, then compare it to my code, and often find a clearer way to split responsibilities or simplify a review comment into a small refactor. It’s practical; it’s human; it’s a peek into real developer choices.

If you’re on a team, this is especially useful, because it shows the conversation as much as the result. Expect to take away concrete patterns, quicker reviews, and maybe fewer long afternoons spent arguing over naming. In short, a helpful reference that nudges your app toward clarity. Give it a read, test what fits, and keep what makes your code kinder to future you.

————————————————————

Deutsch: Unoffizieller 37signals Rails-Leitfaden aus Fizzy

Suchst du nach klaren Rails-Patterns, die sich in deinen Projekten wiederverwenden lassen? Dieser Leitfaden fasst Erkenntnisse aus 265 Pull Requests des Fizzy-Projekts zusammen, einem Kanban-ähnlichen Tool von 37signals. Schau hier: https://github.com/marckohlbrugge/unofficial-37signals-coding-style-guide.

Kurz gesagt, du bekommst wiederverwendbare Muster, Entscheidungsfindungen aus Code-Reviews und Beispiele dafür, wie kleine Änderungen die Lesbarkeit enorm steigern können. Sie haben bewusst geschäftsspezifische Logik ausgelassen, damit die Empfehlungen allgemein nützlich bleiben.

Wichtig zu wissen, ein Großteil des Guides wurde von einem Sprachmodell erstellt, darum können manche Details ungenau sein, prüfe also vor dem Kopieren. Die Codebeispiele stehen unter der O’Saasy License, der Rest des Inhaltes ist MIT-lizenziert, lies die Lizenzen kurz durch.

Persönlich nutze ich solche Sammlungen, wenn ich refaktoriere. Ich lese eine PR-Iteration, übertrage den Gedanken auf meinen Code, und oft ergibt sich ein klarer Pfad zum Vereinfachen. In Teams ist das besonders hilfreich, weil du nicht nur das Ergebnis siehst, sondern die Diskussionen dahinter, das macht spätere Reviews leichter.

Fazit: Kein Zauberstab, aber ein praktischer Spiegel für bessere Entscheidungen. Probier es aus, übernimm nur das, was für dich sinnvoll ist, und freu dich über klarere, pflegeleichtere Codebasen.