Adam Gavlák adamgavlak

🆕 Update: See more extensive repo here: https://github.com/marckohlbrugge/unofficial-37signals-coding-style-guide

The Unofficial 37signals/DHH Rails Style Guide

About This Document

This style guide was generated by Claude Code through deep analysis of the Fizzy codebase - 37signals' open-source project management tool.

Why Fizzy matters: While 37signals has long advocated for "vanilla Rails" and opinionated software design, their production codebases (Basecamp, HEY, etc.) have historically been closed source. Fizzy changes that. For the first time, developers can study a real 37signals/DHH-style Rails application - not just blog posts and conference talks, but actual production code with all its patterns, trade-offs, and deliberate omissions.

Vim Manipulation Cheat Sheet

Action

Key	Result
`v`	select
`y`	copy (yank)
`c`	change
`d`	delete

Rails 7 new features. Before and After

Add ComparisonValidator
PostgreSQL generated columns
PostgreSQL custom enum types
Add tracking of belongs_to association
association_previously_changed? method
Add invert_where method
Add associated method
Add missing method
Active Record Encryption

'Users hate change'

This week NN Group released a video by Jakob Nielsen in which he attempts to help designers deal with the problem of customers being resistant to their new site/product redesign. The argument goes thusly:

Humans naturally resist change
Your change is for the better
Customers should just get used to it and stop complaining

There's slightly more to it than that, he caveats his argument with requiring you to have of course followed their best practices on product design, and allows for a period of customers being able to elect to continue to use the old site, although he says this is obviously only a temporary solution as you don't want to support both.

Database do's and don'ts

This is a generic guidline that applies mostly to Ruby on Rails and Postgres, but can be usefull for running any database migrations in CI.

	# Optimistic Builds for Kamal
	#
	# This workflow speeds up deploys by building the Docker image in parallel with CI.
	# Instead of: CI → Build → Deploy (sequential)
	# We do: CI ↘
	# → Deploy
	# Build ↗
	#
	# The "optimistic" part: we start building before knowing if tests pass.
	# Since CI usually passes, this saves ~2 minutes per deploy.

	class BaseClient
	class APINotFound < StandardError; end

	attr_reader :auth_strategy

	def initialize(auth_strategy: :headers, headers: {})
	@auth_strategy = auth_strategy
	@headers = headers
	end

	#!/usr/bin/env bash

	# Abort sign off on any error
	set -e

	# Start the benchmark timer
	SECONDS=0

	# Repository introspection
	OWNER=$(gh repo view --json owner --jq .owner.login)

	// Made with Amplify Shader Editor
	// Available at the Unity Asset Store - http://u3d.as/y3X
	Shader "Unlit/Directional Tint"
	{
	Properties
	{
	_MainTex("MainTex", 2D) = "white" {}
	_Color("Color", Color) = (1,1,1,1)
	_ColorA("ColorA", Color) = (1,1,1,1)
	_ColorB("ColorB", Color) = (1,1,1,1)

	<%= form_with(model: billboard) do \|form\| %>
	<%= tag.div class: "dropzone", data: { controller: "dropzone", dropzone_param_name_value: "billboard[images][]", dropzone_url_value: rails_direct_uploads_url, dropzone_accepted_files_value: "image/*", dropzone_max_files_value: 3, dropzone_max_filesize_value: 0.300 } do %>
	<div class="dz-default dz-message flex flex-col items-center">
	<%= image_tag "upload.svg", size: 28, class: "colorize-black", aria: { hidden: true } %>
	<h5 class="font-semibold mbs-4">Drop files here or click to upload.</h5>
	<p class="text-sm text-subtle">Upload up to 10 files.</p>
	</div>
	<% end %>

	<div class="inline-flex items-center mbs-2 mie-1">