rollup-plugin-replace-shebangPreserve Shebang in Your Bundle

A Rollup plugin that preserves and relocates shebang (#!) to the output bundle

Get Started

View on GitHub

🔧

Simple Integration

Works seamlessly with Rollup 2.x, 3.x, and 4.x with zero configuration

📦

CLI Ready

Automatically preserves shebang for CLI tools built with Rollup

🎯

Flexible Options

Custom shebang, template variables, include/exclude patterns, and chmod support

🔌

Plugin API

Exposes API for external access to shebang information

⚡

TypeScript First

Full TypeScript support with comprehensive type definitions

🛡️

Validation

Built-in shebang validation and multiple shebang detection

Quick Start

Install

bash

# pnpm
pnpm add -D rollup-plugin-replace-shebang

# npm
npm install -D rollup-plugin-replace-shebang

Usage

import replaceShebang from 'rollup-plugin-replace-shebang'

export default {
  input: 'src/cli.js',
  output: {
    file: 'dist/cli.js',
    format: 'es'
  },
  plugins: [
    replaceShebang({
      chmod: true  // Make output executable
    })
  ]
}

Why rollup-plugin-replace-shebang?

Automatic Preservation: No need to manually add shebang to output files
Works with All Rollup Versions: Compatible with Rollup 2.x, 3.x, and 4.x
Template Variables: Use ${name} and ${version} in custom shebangs
File Pattern Support: Include/exclude specific files with glob patterns
Executable Permissions: Optionally set chmod +x on output files