propshaft

Guide Rails 8+ asset management with the Propshaft pipeline.

5|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/ThinkOodle/rails-skills --skill propshaft
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: propshaft
Source: https://github.com/ThinkOodle/rails-skills/tree/main/skills/propshaft
Command: npx skills add https://github.com/ThinkOodle/rails-skills --skill propshaft

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides expert guidance on managing assets (CSS, images, fonts) in Rails 8+ applications using the modern Propshaft asset pipeline, ensuring efficient delivery and cache-busting.

Core Features & Use Cases

  • Asset Pipeline Management: Understand and configure Propshaft for Rails 8+.
  • CSS Organization: Implement best practices using @layer and CSS custom properties.
  • Asset Referencing: Correctly link to images, fonts, and stylesheets in views and CSS.
  • Deployment & CDN: Configure assets for production deployment and CDN integration.
  • Migration: Migrate smoothly from the older Sprockets asset pipeline.
  • Use Case: You need to organize your application's CSS files, ensure proper cascade order with @layer, and set up fingerprinting for production deployment.

Quick Start

Use the propshaft skill to add a new stylesheet named 'custom_styles.css' to the application.

Frequently Asked Questions about propshaft

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate my Rails asset pipeline from Sprockets to Propshaft?

To migrate from Sprockets to Propshaft, remove Sprockets directives and transition asset referencing to Propshaft's URL formats. The pipeline automatically handles fingerprinting and cache-busting for production without manual configuration.

How do I correctly reference images and fonts in CSS using Propshaft?

You reference images and fonts in CSS using standard relative paths processed by Propshaft. Avoid incorrect Sprockets-style URL formats or directives, ensuring the pipeline properly fingerprints and serves the assets.

Does Propshaft work with JavaScript import maps in Rails 8?

Yes, Propshaft integrates seamlessly with JavaScript import maps in Rails 8. The pipeline manages static assets while import maps handle JavaScript module loading without requiring a bundling step.

What is the best way to organize CSS files with Propshaft?

The best way to organize CSS files with Propshaft is by using CSS @layer and custom properties. This approach controls cascade order and design tokens efficiently within the modern Rails asset pipeline.

How do I configure Propshaft for production deployment and CDN integration?

You configure Propshaft for production deployment by ensuring proper asset fingerprinting and setting up CDN integration. This setup guarantees efficient asset delivery and automatic cache-busting for your Rails application.

Why are my Sprockets asset directives not working after switching to Propshaft?

Sprockets directives do not work in Propshaft because it modernizes the Rails asset pipeline by removing preprocessing steps. You must replace directive syntax with standard asset referencing and URL formats.