Roller Bundler

0.0.2 verified Fri May 01 auth: no javascript

Roller is a minimal library bundler built on top of Rollup, designed for quick setup and zero configuration. It wraps Rollup's capabilities into a simple CLI command, targeting library authors who want to bundle TypeScript/JavaScript without complex configuration. Version 0.0.2 is in early development, with no stable release cadence. Unlike Rollup directly, Roller abstracts away configuration but offers limited customization. Key differentiator: simplicity over flexibility.

Common errors

error Cannot find module 'roller-bundler' ↓

cause Package not installed or ESM-only and used with require()

fix

Install as dev dependency and use import syntax or set type: module in package.json.

error TypeError: roller is not a function ↓

cause Calling the default import as a constructor or without parentheses

fix

Use roller() with parentheses after import.

error Error: No input files found. Expected src/index.js or src/index.ts ↓

cause Default entry point missing. Roller expects a source file in src/.

fix

Create either src/index.js or src/index.ts as your entry point.

Warnings

gotcha Roller does not support custom Rollup plugins or configuration. For advanced use cases, use Rollup directly. ↓

fix Use Rollup with rollup.config.js if you need plugins.

breaking Version 0.0.2 changed CLI output directory from build/ to dist/. Existing scripts may break. ↓

fix Update paths or use --output option if available (check docs).

deprecated The roll export is deprecated in favor of the default export. Will be removed in next major. ↓

fix Use import roller from 'roller-bundler' instead.

Install

npm install roller-bundler

yarn add roller-bundler

pnpm add roller-bundler

Imports

default
wrong
```
const roller = require('roller-bundler')
```
correct
```
import roller from 'roller-bundler'
```
Package is ESM-only (exports default function). CommonJS require will fail.

BundleConfig

wrong

import { BundleConfig } from 'roller-bundler'

correct

import type { BundleConfig } from 'roller-bundler'

TypeScript type export. Do not use at runtime.

roll

wrong

import roll from 'roller-bundler/roll'

correct

import { roll } from 'roller-bundler'

Named export, not a separate module. Available in ESM only.

Quickstart

Install roller-bundler as dev dependency and run with npx to bundle with zero config. Expects source files in src/, outputs to dist/.

npm install roller-bundler -D
npx roller