Quickbundle is a zero-configuration transpiler and bundler for web projects, currently at version 2.16.0. It aims to simplify the build process by allowing developers to define build artifacts directly in `package.json`. The library boasts fast build and watch modes, leveraging powerful underlying tools such as Rollup and SWC. It supports various module formats (CJS, ESM), loaders for JavaScript, TypeScript, JSX, JSON, and Images, and includes TypeScript declaration file bundling. A key differentiator is its ability to compile and cross-compile standalone executables for environments without Node.js. The project has a frequent release cadence, with minor and patch updates often occurring multiple times a month, primarily focused on dependency updates and feature enhancements like dynamic import support.
npm install quickbundleVerified import paths — ran on the pinned version, not inferred.
This quickstart demonstrates how to set up and run a build using `quickbundle` for a TypeScript project, primarily showing its CLI usage which is the recommended zero-config approach.
Review your build scripts and any programmatic usage of `quickbundle` when upgrading to `2.12.0` or later. Consult the official GitHub repository for detailed migration steps if issues arise.
Always test your builds thoroughly after updating `quickbundle`. Pin your `quickbundle` version (`"quickbundle": "~2.x.x"` or `"quickbundle": "2.x.x"`) if stability is critical for your project, and only update after verifying compatibility.
Ensure that a compatible version of `typescript` is installed as a `devDependency` in your project. If you encounter TypeScript-related errors, try updating your `typescript` package to match `quickbundle`'s peer dependency requirements.
Upgrade to `quickbundle@2.16.0` or higher to ensure proper support for dynamic imports.
For `compile` mode, simplify your dependency graph where possible. Ensure your main entry point and critical dependencies are compatible with a CommonJS output. Carefully test the generated executable in your target environment.
Run `npm install quickbundle` (or `pnpm add quickbundle`, `yarn add quickbundle`) in your project's root directory. Ensure that `node_modules` is present and accessible, or use `npx` to execute the CLI directly.
Check your `tsconfig.json` for `target` settings. Update your `typescript` peer dependency to match `quickbundle`'s requirements. Review `quickbundle`'s changelog for specific updates to SWC or Rollup that might affect parsing behavior.
Use `npx quickbundle [command]` to run the command via the local `node_modules/.bin` directory. If you want to use `quickbundle` globally, install it with `npm install -g quickbundle`, though `npx` is generally preferred.
Upgrade `quickbundle` to version `2.16.0` or newer, which introduced support for dynamic imports. Review your `package.json` `source` and build configurations.