asset-pipeline-propshaft

What problem does it solve?

Rails 8 replaced the default Sprockets asset pipeline with Propshaft, leaving many developers unsure how to set up new apps correctly or migrate existing Sprockets projects without breaking functionality. This Skill eliminates guesswork by providing clear, senior Rails developer-vetted guidance for all Propshaft-related workflows, avoiding common missteps like misconfigured bundlers or broken asset caching.

Core Features & Use Cases

• Greenfield Rails 8 Setup: Guides selection of the right JavaScript (Importmap, jsbundling-rails, vite_ruby) and CSS (cssbundling-rails, Tailwind, Dart Sass) bundlers for your app's complexity.
• Sprockets Migration: Provides a step-by-step audit process to identify incompatible Sprockets features (like .scss.erb or manifest directives) and a safe migration workflow that avoids combining with Rails version upgrades.
• Production Configuration: Covers CDN asset host setup, digest stamping for cache busting, and far-future expiry header configuration for optimal performance.
• Pitfall Avoidance: Explicitly calls out common mistakes to refuse, such as attempting to use Sprockets-specific preprocessing with Propshaft or shipping public sourcemaps.

Quick Start

Use the asset-pipeline-propshaft skill to configure the asset pipeline for your new Rails 8 application using Propshaft and the appropriate bundlers for your project's JavaScript and CSS needs.