# Ruby project architecture examples

Interactive architecture diagrams of 101 open-source Ruby repositories with a GitDiagram architecture diagram, most stars first. Each diagram shows the project's main components, how they connect, and links every part to its file on GitHub.

Across the 43 most-starred Ruby projects here, the median diagram has 20 components. 63% draw a data store (most often PostgreSQL, Redis and a cache), 26% have a command-line interface and 9% a web interface.

21% have a plugin or extension system and 16% draw a queue or event bus.

The files their components link to most are routes.rb (6), application_controller.rb (4), client.rb (4), configuration.rb (4) and search.rb (4).

Group names that recur: “administration” (2), “async & integrations” (2), “automation” (2), “browser experience” (2) and “platform services” (2).

## Repositories 1 to 50 of 101

1. [rails/rails](https://gitdiagram.com/rails/rails) (58.8k stars): Rails is an MVC web application framework with independently usable libraries for persistence, background jobs, email, WebSockets, file attachments, and rich text. Markdown: https://gitdiagram.com/rails/rails.md
2. [maybe-finance/maybe](https://gitdiagram.com/maybe-finance/maybe) (54.1k stars): - This is a Ruby on Rails monolith for personal finance management. Markdown: https://gitdiagram.com/maybe-finance/maybe.md
3. [jekyll/jekyll](https://gitdiagram.com/jekyll/jekyll) (51.5k stars): Jekyll is a static‐site generator implemented as a Ruby gem and CLI tool. Markdown: https://gitdiagram.com/jekyll/jekyll.md
4. [mastodon/mastodon](https://gitdiagram.com/mastodon/mastodon) (50.4k stars): Mastodon is a federated social-network server. Markdown: https://gitdiagram.com/mastodon/mastodon.md
5. [homebrew/brew](https://gitdiagram.com/homebrew/brew) (50k stars): Homebrew is a macOS/Linux package manager: users invoke brew commands to find, install, update, and manage formulae and casks, with brew bundle and brew services providing… Markdown: https://gitdiagram.com/homebrew/brew.md
6. [huginn/huginn](https://gitdiagram.com/huginn/huginn) (49k stars) Markdown: https://gitdiagram.com/huginn/huginn.md
7. [discourse/discourse](https://gitdiagram.com/discourse/discourse) (48k stars): Discourse is a self-hostable community platform. Markdown: https://gitdiagram.com/discourse/discourse.md
8. [fastlane/fastlane](https://gitdiagram.com/fastlane/fastlane) (41.8k stars): fastlane is a Ruby-distributed automation suite for iOS, Android, and Apple-platform release workflows: defining build/test/release lanes, managing signing, producing… Markdown: https://gitdiagram.com/fastlane/fastlane.md
9. [freecodecamp/devdocs](https://gitdiagram.com/freecodecamp/devdocs) (39.5k stars): DevDocs turns third-party reference material into normalized, indexed documentation, then serves it through a browser-based documentation and search interface. Markdown: https://gitdiagram.com/freecodecamp/devdocs.md
10. [rapid7/metasploit-framework](https://gitdiagram.com/rapid7/metasploit-framework) (39.1k stars): Metasploit Framework is a security testing platform whose README identifies msfconsole as its primary interface. Markdown: https://gitdiagram.com/rapid7/metasploit-framework.md
11. [chatwoot/chatwoot](https://gitdiagram.com/chatwoot/chatwoot) (37.2k stars): Chatwoot is an omnichannel customer-support platform: customers contact a business through supported channels, conversations are handled and routed in the support workspace, and… Markdown: https://gitdiagram.com/chatwoot/chatwoot.md
12. [hashicorp/vagrant](https://gitdiagram.com/hashicorp/vagrant) (27.2k stars): Vagrant is an application that abstracts various virtualization and container environments (such as VirtualBox, VMware, Docker, Hyper-V, etc.) to let developers set up… Markdown: https://gitdiagram.com/hashicorp/vagrant.md
13. [matteocrippa/awesome-swift](https://gitdiagram.com/matteocrippa/awesome-swift) (26.3k stars): Awesome Swift is a curated directory of Swift-related learning resources, tools, libraries, and projects. Markdown: https://gitdiagram.com/matteocrippa/awesome-swift.md
14. [gitlabhq/gitlabhq](https://gitdiagram.com/gitlabhq/gitlabhq) (24.6k stars): GitLab is a Rails collaboration and DevOps platform. Markdown: https://gitdiagram.com/gitlabhq/gitlabhq.md
15. [heartcombo/devise](https://gitdiagram.com/heartcombo/devise) (24.3k stars): – A “Gem/Engine Layer” that includes the principal code (found in lib/) with its many modules (models, strategies, hooks, mailers, controllers, etc.). Markdown: https://gitdiagram.com/heartcombo/devise.md
16. [ruby/ruby](https://gitdiagram.com/ruby/ruby) (23.7k stars): Ruby is an interpreted, object-oriented language runtime. Markdown: https://gitdiagram.com/ruby/ruby.md
17. [forem/forem](https://gitdiagram.com/forem/forem) (22.8k stars): Forem is a Rails community platform for publishing and discovering content, participating in discussions, and managing community identities and spaces. Markdown: https://gitdiagram.com/forem/forem.md
18. [lewagon/setup](https://gitdiagram.com/lewagon/setup) (19.5k stars): The heart of the project is its Markdown-based guides. Markdown: https://gitdiagram.com/lewagon/setup.md
19. [postalserver/postal](https://gitdiagram.com/postalserver/postal) (16.4k stars): This is Postal: a self-hosted, full-featured mail server written in Ruby on Rails. It provides. Markdown: https://gitdiagram.com/postalserver/postal.md
20. [opf/openproject](https://gitdiagram.com/opf/openproject) (16.3k stars): OpenProject is a self-hosted project-management and team-collaboration platform. Markdown: https://gitdiagram.com/opf/openproject.md
21. [spree/spree](https://gitdiagram.com/spree/spree) (15.7k stars): Spree is an open-source commerce platform spanning a Rails commerce backend, REST APIs and typed clients, React admin and seller dashboards, and project tooling. Markdown: https://gitdiagram.com/spree/spree.md
22. [homebrew/homebrew-core](https://gitdiagram.com/homebrew/homebrew-core) (15.6k stars): Homebrew Core is the default catalog of formula definitions used by brew install. Markdown: https://gitdiagram.com/homebrew/homebrew-core.md
23. [basecamp/kamal](https://gitdiagram.com/basecamp/kamal) (14k stars): Kamal is a deployment tool designed to deploy containerized web apps (originally for Rails, but generalizable) across bare metal servers and cloud VMs. Markdown: https://gitdiagram.com/basecamp/kamal.md
24. [diaspora/diaspora](https://gitdiagram.com/diaspora/diaspora) (13.7k stars): diaspora* is a privacy-aware, distributed social network hosted by independently operated pods. Markdown: https://gitdiagram.com/diaspora/diaspora.md
25. [fluent/fluentd](https://gitdiagram.com/fluent/fluentd) (13.5k stars): Core Engine: Represent the central Fluentd engine (located in lib/fluent/engine.rb and related files) that orchestrates the data flow. Markdown: https://gitdiagram.com/fluent/fluentd.md
26. [sidekiq/sidekiq](https://gitdiagram.com/sidekiq/sidekiq) (13.5k stars) Markdown: https://gitdiagram.com/sidekiq/sidekiq.md
27. [github-linguist/linguist](https://gitdiagram.com/github-linguist/linguist) (13.4k stars): Core Ruby Library: Represent the “lib/linguist” directory that contains the primary Ruby classes (e.g. Markdown: https://gitdiagram.com/github-linguist/linguist.md
28. [rubocop/rubocop](https://gitdiagram.com/rubocop/rubocop) (12.8k stars): RuboCop is an open-source, full-featured static code analyzer and formatter for Ruby. Markdown: https://gitdiagram.com/rubocop/rubocop.md
29. [sinatra/sinatra](https://gitdiagram.com/sinatra/sinatra) (12.4k stars) Markdown: https://gitdiagram.com/sinatra/sinatra.md
30. [ubicloud/ubicloud](https://gitdiagram.com/ubicloud/ubicloud) (12k stars): Control Plane: This is the core Ruby application that handles web requests (via the Roda framework), authentication (using Rodauth), and database interactions (through Sequel). Markdown: https://gitdiagram.com/ubicloud/ubicloud.md
31. [faker-ruby/faker](https://gitdiagram.com/faker-ruby/faker) (11.9k stars): Faker is a Ruby library for generating realistic-looking sample data for tests, demos, and development. Markdown: https://gitdiagram.com/faker-ruby/faker.md
32. [shopify/liquid](https://gitdiagram.com/shopify/liquid) (11.7k stars): This is an open-source Ruby library implementing the Liquid template engine (liquid.gemspec, lib/liquid). Markdown: https://gitdiagram.com/shopify/liquid.md
33. [docusealco/docuseal](https://gitdiagram.com/docusealco/docuseal) (11.6k stars): Within it, note that the views (app/views) and JavaScript assets (app/javascript) form the primary UI layer. Markdown: https://gitdiagram.com/docusealco/docuseal.md
34. [we-promise/sure](https://gitdiagram.com/we-promise/sure) (10k stars): Sure is a self-hostable personal-finance and wealth-management platform. Markdown: https://gitdiagram.com/we-promise/sure.md
35. [antiwork/gumroad](https://gitdiagram.com/antiwork/gumroad) (9.9k stars): Gumroad is a creator-commerce web application: creators offer products and consumers purchase and use them. Markdown: https://gitdiagram.com/antiwork/gumroad.md
36. [wpscanteam/wpscan](https://gitdiagram.com/wpscanteam/wpscan) (9.8k stars): WPScan is a WordPress security scanner. Markdown: https://gitdiagram.com/wpscanteam/wpscan.md
37. [activeadmin/activeadmin](https://gitdiagram.com/activeadmin/activeadmin) (9.7k stars): Admin Engine & DSL: At the core, Active Admin provides a DSL (defined in files within the “lib” directory and generators) that lets developers declare administrative resources… Markdown: https://gitdiagram.com/activeadmin/activeadmin.md
38. [kaminari/kaminari](https://gitdiagram.com/kaminari/kaminari) (8.7k stars): This is an open-source Ruby pagination library (“Kaminari”) structured as a monorepo that bundles three gems. Markdown: https://gitdiagram.com/kaminari/kaminari.md
39. [community/community](https://gitdiagram.com/community/community) (8.4k stars): This repository is primarily a GitHub Discussions community hub plus a GitHub Actions automation layer. Markdown: https://gitdiagram.com/community/community.md
40. [freika/dawarich](https://gitdiagram.com/freika/dawarich) (8.4k stars) Markdown: https://gitdiagram.com/freika/dawarich.md
41. [chef/chef](https://gitdiagram.com/chef/chef) (8.4k stars): CLI Tools & Applications: Directories such as “chef-bin” and “knife” contain the command-line utilities. Markdown: https://gitdiagram.com/chef/chef.md
42. [thoughtbot/factory_bot](https://gitdiagram.com/thoughtbot/factory_bot) (8.4k stars): Client Code / Integration Layer – This represents the consumer of the gem (e.g., Rails, RSpec, or other Ruby applications that use factory_bot). Markdown: https://gitdiagram.com/thoughtbot/factory_bot.md
43. [basecamp/fizzy](https://gitdiagram.com/basecamp/fizzy) (7.9k stars): - This is a Ruby on Rails monolith for a Kanban-style product called Fizzy. Markdown: https://gitdiagram.com/basecamp/fizzy.md
44. [puma/puma](https://gitdiagram.com/puma/puma) (7.9k stars) Markdown: https://gitdiagram.com/puma/puma.md
45. [puppetlabs/puppet](https://gitdiagram.com/puppetlabs/puppet) (7.8k stars): Puppet is an open-source, Ruby-based configuration management framework. Markdown: https://gitdiagram.com/puppetlabs/puppet.md
46. [github/scientist](https://gitdiagram.com/github/scientist) (7.7k stars): This is a Ruby library (a gem) named “Scientist” that instruments your application code to run two behaviors (“control” and “candidate”) side-by-side, compare their results… Markdown: https://gitdiagram.com/github/scientist.md
47. [chyingp/nodejs-learning-guide](https://gitdiagram.com/chyingp/nodejs-learning-guide) (6.9k stars): This is a static documentation/book site for Node.js learning, organized as Markdown content (core modules, examples, advanced topics) and built with a static-site tool (GitBook… Markdown: https://gitdiagram.com/chyingp/nodejs-learning-guide.md
48. [instructure/canvas-lms](https://gitdiagram.com/instructure/canvas-lms) (6.9k stars): Canvas is an open-source learning management system. Markdown: https://gitdiagram.com/instructure/canvas-lms.md
49. [pry/pry](https://gitdiagram.com/pry/pry) (6.8k stars): – Pry::CLI (argument parsing, configuration loading) Markdown: https://gitdiagram.com/pry/pry.md
50. [hanami/hanami](https://gitdiagram.com/hanami/hanami) (6.4k stars) Markdown: https://gitdiagram.com/hanami/hanami.md

Next page: https://gitdiagram.com/architecture-examples/ruby/2

More hubs: https://gitdiagram.com/architecture-examples

Counted over GitDiagram's stored diagrams of public repositories, from the names their components and groups carry and the files they link to; the rules are the ones in the [2026 open-source architecture report](https://gitdiagram.com/open-source-architecture-2026). Stars are GitHub's when the diagram was last made. Rebuilt daily: hubs grow as more repositories' languages are known.