Build your library for any JavaScript environment without the complexity
SmartBundle makes it easy to bundle your library for any JavaScript environment. Just create a minimal package.json (see below), install SmartBundle, and run the build command.
{
// Your package name
"name": "my-package",
// Package version
"version": "1.0.0",
// Must be true to avoid accidental publishing
"private": true,
// SmartBundle supports only ES modules
"type": "module",
// Entry point used by SmartBundle
"exports": "./src/index.js",
"scripts": {
// Run this to build your package
"build": "smartbundle"
}
}Need more details? See our package.json guide for a full explanation of each field. If you plan to use TypeScript, check out our TS guide for tailored advice.
To build your package:
- Create the package.json as shown above
- Install SmartBundle:
npm install --save-dev smartbundle@latest- Build your package:
npm run build- Your built files (including an auto-generated package.json) will be in the ./dist folder
- Zero Configuration - Point to your entry file and build
- Universal Output - ESM and CommonJS bundles generated automatically
- TypeScript Ready - Full TypeScript support with type definitions
- React Support - Automatic JSX transformations for modern and legacy modes
- Developer Friendly - Source maps included for better debugging
- Broad Compatibility - Works with Node.js, Webpack, Vite, Rollup, Bun, and more
Every bundled package is tested in real environments - from Node.js and Bun to Webpack and Metro - to ensure it just works.
| Runtime | Version | Supported | E2E Tests |
|---|---|---|---|
| Node.js | ^18.0.0 | ✔ | ✔ |
| ^20.0.0 | ✔ | ✔ | |
| ^22.0.0 | ✔ | ✔ | |
| ^23.0.0 | ✔ | ✔ | |
| Bun | ^1.0.0 | ✔ | ✔ |
| Deno | ^2.0.0 | ✔ | - |
| Bundler | Version | Supported | E2E Tests |
|---|---|---|---|
| Webpack | ^4.47.0 | ✔ | ✔ |
| ^5.95.0 | ✔ | ✔ | |
| Rspack | ^1.0.0 | ✔ | ✔ |
| Vite | ^5.0.0 | ✔ | - |
| Rollup | ^4.0.0 | ✔ | - |
| Parcel | ^2.0.0 | ✔ | - |
| Browserify | ^17.0.0 | ✔ | - |
| Esbuild | ^0.24.0 | ✔ | - |
| Metro | ^0.81.0 | ✔ | ✔ |
| Next.js/Turbopack | ^13.0.0 | ✔ | - |
| Strategy | Supported | E2E Tests |
|---|---|---|
| bundler | ✔ | ✔ |
| node10 | ✔ | ✔ |
| node16es | ✔ | ✔ |
| node16cjs | ✔ | ✔ |
We aim to support as many bundlers and runtimes as possible. If the bundled package doesn't work with your bundler, please let us know.
SmartBundle automatically detects and integrates with your tools - just add what you need to your project.
Add typescript@^5.0.0 as a dev dependency and start creating .ts files. SmartBundle will handle the rest.
Add @babel/core@^7.0.0 as a dev dependency and create a Babel configuration file in your project root. SmartBundle will automatically apply your transformations.
Add react to your dependencies. SmartBundle automatically detects React and configures JSX transformations. Both modern and legacy modes are supported.
For detailed React configuration options, see our React guide.
SmartBundle enforces certain package.json conventions to ensure reliable builds. For detailed information about:
- Required and banned fields
- Configuration limitations
- Package.json best practices
See our package.json guide.
Please, look at the known fixable issues before creating your own one. Some bugs already have a solution but cannot be fixed without user action.
Minification is typically needed only for production. During development, readable, unminified output helps with debugging.
We prioritize keeping the node_modules size manageable and avoid unnecessary dependencies. If your package does not require TypeScript, for instance, you don’t need to install those specific tools.
If you need assistance or wish to contribute, please check out our discussion forum and issue tracker.