rails/tailwindcss-rails
63.4
Adequate · 6 November 2026
387
lines of production code
Ruby
primary language
4
measurements over time
What this system is
Features
Add Puma plugin for automatic Tailwind CSS watch process management
A new Puma plugin (\lib/puma/plugin/tailwindcss.rb\) is introduced to automatically start, monitor, and stop the Tailwind CSS watch process alongside the Puma server. The plugin uses \IO.popen\ to launch the \bin/rails tailwindcss:watch\ command, ensuring that standard input remains available for tools like IRB or debuggers. It includes background monitoring to stop the Tailwind process if Puma exits and vice versa. Additionally, the plugin handles Puma 7 compatibility by using \after\_stopped\ instead of \on\_stopped\ for event registration.
lib/puma · high confidence
Add Tailwind CSS mailer generator with customizable templates
Users can now generate mailers with Tailwind CSS-compatible HTML and text templates. The new \Tailwindcss::Generators::MailerGenerator\ inherits from Rails' default ERB mailer generator but allows applications to override the generated templates by placing custom files in \lib/templates/erb/mailer\. The included default templates provide basic HTML and text layouts for mailer views.
lib/generators/tailwindcss/mailer · high confidence
Add Tailwind CSS scaffold generator
Introduces a new scaffold generator that produces views styled with Tailwind CSS. This generator extends the standard Rails ERB scaffold generator to provide Tailwind-specific templates for index, edit, show, new, and form views, along with a partial, allowing users to generate scaffolded resources with pre-styled UI components.
lib/generators/tailwindcss/scaffold · high confidence
Add Tailwind CSS scaffold templates
The generator now produces views styled with Tailwind CSS, replacing the previous default markup. The new templates include a form with improved field styling and error handling, an index page with responsive action buttons and Turbo confirm prompts for destruction, and consistent layout wrappers for new, edit, show, and partial views.
lib/generators/tailwindcss/scaffold/templates · high confidence
Added VS Code devcontainer configuration for Ruby development
Developers can now open the project in VS Code using the Dev Containers extension to get an immediate, consistent development environment. The new configuration in .devcontainer sets up a Ruby 3 container (based on Debian Bullseye) with Node.js LTS, the GitHub CLI, and the rebornix.Ruby extension pre-installed, simplifying local setup and contribution.
.devcontainer · high confidence
New bin scripts for setup, CI, and release
Added \bin/setup\ to install dependencies and optional linting/security tools (actionlint, shellcheck, zizmor) via Homebrew or Pacman; \bin/ci\ to run unit and integration tests (including user install/upgrade scenarios) and optional linting/security checks; and \bin/release\ to version, tag, push, and publish the gem to RubyGems.
bin · high confidence
Behavioural changes
Add Tailwind CSS controller generator with updated view template
The Tailwind CSS integration now includes a dedicated controller generator that inherits from the standard ERB controller generator. This generator uses a custom view template that replaces the previous heading structure with a div-wrapped layout, applying Tailwind utility classes (font-bold, text-4xl) to the controller action title and updating the descriptive paragraph to reference the generated path.
lib/generators/tailwindcss/controller · high confidence
Hide Tailwind CSS authentication generator from public scaffolding list
The Tailwind CSS-specific authentication generator is now hidden from the public list of available generators (rails g). This change ensures that users do not accidentally invoke the Tailwind variant when generating authentication scaffolding, as it is intended to be used internally or via specific configuration rather than as a standalone public option.
lib/generators/tailwindcss/authentication · high confidence
Introduction of Engines, Commands, and Process Runner modules
The library now loads additional internal components to support new functionality. Specifically, it requires the \engines\, \commands\, and \process\_runner\ modules alongside the existing version and engine files. This structural change enables the application of engine-based architecture, command execution logic, and process management for the Tailwind CSS integration.
lib · high confidence
Migrate Tailwind CSS integration to v4 with new asset pipeline and dev server setup
The Tailwind CSS integration has been updated to support version 4, replacing the previous JavaScript-based asset pipeline with a native CSS import approach (\@import "tailwindcss"\) and a new \bin/dev\ script powered by Foreman. This change introduces a \Procfile.dev\ for managing the Rails server and Tailwind watch process, configures the application layout to include a centered container and proper stylesheet tags, and provides an upgrade task (\tailwindcss:upgrade\) that automatically migrates existing configurations, moves PostCSS settings, and runs the official Tailwind upgrader tool. The legacy \tailwindcss.rb\ installer and associated JavaScript assets have been removed.
lib/install · high confidence
Redesigned authentication views with improved mobile responsiveness and focus states
The authentication templates for sign-in, password reset, and password update have been updated to provide a better user experience on mobile devices and improved accessibility. The forms now use responsive width classes to adapt to smaller screens, and input fields feature explicit focus outlines (blue-600) to enhance keyboard navigation visibility.
lib/generators/tailwindcss/authentication/templates · high confidence
Refactored Rake task structure and added Tailwind CSS v4 upgrade support
The monolithic \tailwindcss\_tasks.rake\ has been split into dedicated files (\build.rake\, \clobber.rake\, \install.rake\, \upgrade.rake\) to improve organization. The build and watch tasks now accept \debug\, \silent\, and \verbose\ arguments to control output and asset generation, and the build task is automatically hooked into \assets:precompile\ and test preparation tasks. A new \tailwindcss:upgrade\ task has been introduced to facilitate migration from Tailwind CSS v3 to v4, while the legacy \purge\ task has been removed.
lib/tasks · high confidence
Removal of Tailwind CSS reset styles
The file containing Tailwind CSS reset styles (modern-normalize) has been deleted from the assets directory. This change removes the default browser style resets previously provided by this file, which may alter the baseline styling of the application if those resets are not replaced by another source.
app/assets · high confidence
Tailwind CSS v4 support and engine integration
The gem now supports Tailwind CSS v4, replacing the previous internal CSS purging logic with the native Tailwind build process. This change introduces automatic integration with Rails Engines, which now automatically detect and bundle engine-specific Tailwind stylesheets. Additionally, the gem disables default Rails stylesheet generation to avoid conflicts and ensures the Tailwind configuration directory is excluded from asset precompilation.
lib/tailwindcss · high confidence
Fixes
Fix system test failures when Turbo is present
The test unit scaffold generator now automatically wraps destroy link actions in an \accept\_confirm\ block within generated system tests when Turbo is detected. This prevents test failures caused by Turbo's default confirmation behavior, ensuring generated system tests run successfully out of the box in applications using Turbo.
_lib/generators/test\unit · high confidence
Test coverage
Added integration tests for user install and upgrade journeys; Added test coverage for Tailwind CSS generators; Added tests for Tailwind CSS command generation, engine bundling, and process signal handling; Refactor test infrastructure to use isolated temporary directories and debug gem; Removed test dummy application scaffolding.
Dependencies
161 commits updating dependencies (3 manifests)
A dependency / build maintenance change in (dependencies) — 161 commits (4 fixs), 3 files: “dep: gem version”; “build(deps-dev): bump actionmailer from 8.1.3.1 to 8.1.4 (\#642)”; “build(deps-dev): bump actionmailer from 7.2.0 to 7.2.1”; and 144 more (refs \#642, \#636, \#102, \#630, \#76, …).
(dependencies) · medium confidence · unverified
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
How this codebase got here
Score
- CAI 60 → 63 (+3.8)
- Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.
Lenses
- Code Health 76 → 76 (+0.0)
- Architecture 69 → 69 (+0.0)
- Maturity 47 → 56 (+8.5)
- Readiness 67 → 67 (-0.1)
- Security 87 → 82 (-5.2)
New (3)
- Medium CVE: [GHSA redacted] (Gemfile.lock)
- Outdated: actionmailer
- Outdated: railties
Changes since last survey
- 7 commits — 6 feature/other, 1 fixes
By area
- .github/workflows — 3 commits
- (root) — 2 commits
- (repo) — 1 commit
- lib/tasks — 1 commit
Notable commits
- fix: Merge pull request #647 from afurm/fix-install-task-paths-with-spaces
- change: Pass the template location as a single argument in install/upgrade tasks
- change: build(deps): bump ruby/setup-ruby (#646)
- change: build(deps): bump the github-actions group with 2 updates (#650)
- change: ci: run Ruby 3.1 on ubuntu-24.04 (#649)
- change: doc: update CHANGELOG
- change: version bump to v4.7.0
Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.
Survey your own repository
rails/tailwindcss-rails was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.
About this page
- The score is its most recent published measurement, taken on 6 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
- Measured at commit 36015b158d004ce969baaf8bd8f0d0905f5c6843 — the exact code this score is about.
- Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
- Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.