Install Gem
bundle add shakapackerQuick Start
Install Files
bin/rails shakapacker:installDeploy
bin/rails assets:precompile
Shakapacker + Rspack
2-4x Faster Builds, Same Rails Workflow
Shakapacker ships with first-class Rspack support — a Rust-powered bundler that’s wire-compatible with Webpack 5 but dramatically faster. Switch bundlers with a one-line config change; no migration rewrite needed.
Drop-in Webpack replacement
Rspack is wire-compatible with Webpack 5. Existing loaders, plugins, and config files work without rewriting your build pipeline.
2-4x faster builds
Written in Rust, Rspack delivers dramatically faster cold starts, warm-cache rebuilds, and incremental production builds compared to Webpack.
Rails-native integration
Unlike Vite, Rspack works with Shakapacker out of the box — no ejecting from the Rails asset pipeline, no custom server configuration.
Academia.eduCase Study
2-4x build speed increase. Warm-cache startup went from ~1m to ~20s, and incremental prod builds now take ~10s.
2-4xfaster builds
~20swarm-cache startup
~10sincremental deploys
Jon Rajavuori — ShakaCode helped Academia.edu migrate from Webpack to Rspack
How Shakapacker Compares
Sprockets and Propshaft are Rails’ asset-digesting layer — they fingerprint assets but don’t bundle JavaScript. importmap-rails, jsbundling-rails, Vite Ruby, and Shakapacker are how modern JS actually reaches the browser.
| Option | Build step | npm + loaders | JSX / TS | HMR | Code splitting | Rails manifest + helpers | Best for |
|---|---|---|---|---|---|---|---|
| Sprockets | none (concatenate) | ✗ | ✗ | ✗ | ✗ | ✓ (legacy) | Legacy apps, CSS / images |
| Propshaft | none (digest only) | ✗ | ✗ | ✗ | ✗ | ✓ | Modern digesting; pair with a bundler |
| importmap-rails | none | ✗ | ✗ | ✗ | ✗ | ✓ (Propshaft) | No-build Hotwire |
| jsbundling-rails | esbuild / rollup / bun | minimal | ✓ | ✗ | limited | ✓ (Propshaft) | Simple modern JS |
| Vite Ruby | Vite | Vite ecosystem | ✓ | ✓ | ✓ | own pipeline | Teams wanting Vite DX |
| Shakapacker + Rspack | webpack or Rspack | full ecosystem | ✓ SWC / Babel / esbuild | ✓ | ✓ | ✓ native | Complex / React / TS at scale |
Why Teams Use It
Installation, configuration, and deployment guidance is sourced directly from the shakapacker/docs tree.
Keep webpack-style configuration and Rails conventions while switching the build engine to Rspack for major speed gains.
Docs Architecture
Canonical markdown stays in shakapacker/docs. This site syncs that content at build time, so docs stay co-located with the code while deployment remains independent.
Expert Help
Get direct guidance from the team behind Shakapacker
Planning a Webpack-to-Rspack migration or troubleshooting production builds? Book a complimentary 30-minute assessment with ShakaCode.