# jsbundling-rails
> A Rails gem that provides installers and rake tasks for popular JavaScript bundlers like esbuild, webpack, and rollup, enabling modern JavaScript tooling while maintaining Rails asset pipeline integration.

# Modern JavaScript bundling for Rails applications

jsbundling-rails is a Rails gem that bridges modern JavaScript bundlers with Rails' asset pipeline, enabling developers to use tools like esbuild, webpack, rollup, and Bun while maintaining Rails conventions. **Part of Rails 7's modular asset management strategy**, it provides the flexibility of modern JavaScript tooling without abandoning Rails' asset pipeline benefits.

## What jsbundling-rails solves

Traditional Rails applications struggled with modern JavaScript requirements like TypeScript transpilation, JSX support, and npm package management. jsbundling-rails addresses these needs by providing lightweight integrations with popular bundlers while preserving Rails' asset fingerprinting, caching, and deployment processes.

The gem operates on a simple principle: bundlers process JavaScript files from `app/javascript/` and output compiled assets to `app/assets/builds/`, where Rails' asset pipeline handles final serving and optimization.

## Supported bundlers and their strengths

**esbuild** emerges as the recommended choice for most Rails applications. Written in Go, it delivers **extremely fast compilation** with built-in TypeScript and JSX support. Setup requires minimal configuration via package.json build scripts, making it ideal for teams prioritizing speed and simplicity.

**webpack** remains the most flexible option, offering extensive plugin ecosystem and advanced features like code splitting and hot module replacement. Its comprehensive configuration via webpack.config.js suits complex applications requiring sophisticated build processes.

**rollup.js** excels at tree-shaking and produces clean ES module output, making it particularly valuable for library development and applications where bundle size optimization is critical.

**Bun** represents the newest addition, providing an all-in-one JavaScript runtime with very fast performance for projects already invested in the Bun ecosystem.

## Integration with Rails asset pipeline

The technical architecture demonstrates Rails' evolved approach to asset management. During development, the `./bin/dev` script runs both Rails server and bundler watch mode concurrently. The bundler processes source files and outputs to `app/assets/builds/`, while Rails' asset pipeline handles fingerprinting and serving.

This separation of concerns allows developers to **leverage modern JavaScript tooling** without losing Rails' deployment and caching benefits. The gem integrates seamlessly with `rails assets:precompile` for production deployments, ensuring bundled assets are properly processed during deployment.

## Comparison with Rails alternatives

Against **importmap-rails**, jsbundling-rails trades simplicity for capability. While importmap-rails eliminates build steps entirely, jsbundling-rails enables TypeScript, JSX, and complex npm package usage. The choice depends on application complexity and team preferences.

Compared to the deprecated **Webpacker**, jsbundling-rails offers lighter weight integration with multiple bundler options instead of heavy webpack-only configuration. This flexibility allows teams to choose the best tool for their specific needs.

## Current status and adoption

As of 2024, jsbundling-rails maintains active development by the Rails core team with version 1.3.1 representing the latest stable release. **Growing adoption** among Rails developers, particularly for TypeScript and React applications, demonstrates its value as a migration path from Webpacker.

The gem's **Rails 8 compatibility** and integration with Propshaft ensure its continued relevance in Rails' asset management evolution, making it a solid choice for Rails applications requiring modern JavaScript capabilities while maintaining Rails conventions.
