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.