Shopify/packwerk

Health v2 · maintenance only

Adoption not part of the score

1907 stars · 122 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Packwerk is a Ruby gem from Shopify that enforces architectural boundaries and modularization in Rails applications by grouping files into packages and checking constant references against package dependencies. It helps large existing codebases become more modular incrementally without blocking development.

Use cases

• enforce package boundaries in a rails monolith
• modularize a large ruby codebase
• detect cross-package constant references
• define public APIs for ruby packages
• prevent dependency violations between modules
• gradually split a rails app into packages

When to choose

• you maintain a large Rails 6+ app using Zeitwerk and want enforced modularity
• you want to catch boundary violations in CI before code review
• you're incrementally decomposing a monolith into packages

When to avoid

• your project is not Ruby or doesn't use Zeitwerk autoloading
• you need a general-purpose dependency graph visualizer rather than enforcement
• your codebase is small enough that modular boundaries add overhead without benefit

Facets

library · maturity active

linter developer-tools cli developer-tools web-development backend ruby cli modularization architecture-boundaries rails code-structure static-analysis

Member repositories

For agents

markdown · JSON · MCP: product_card(name="Shopify/packwerk")