A unified JavaScript build system
Note
We are experimenting with obuild as the next next-gen successor based on rolldown.
If you mainly need faster build speeds and don't mind trying beta software, give it a try!
Robust rollup based bundler that supports TypeScript and generates CommonJS and module formats + type declarations.
Automagically infer build config and entries from package.json.
Integration with mkdist for generating bundleless dists with file-to-file transpilation.
Stub dist once using unbuild --stub (powered by jiti) and you can try and link your project without needing to watch and rebuild during development.
Integration with untyped.
Automatically check for various build issues such as potential missing and unused dependencies and fail CI.
CLI output also includes output size and exports for quick inspection.
Create src/index.ts:
export const log = (...args) => { console.log(...args); };
Update package.json:
{
"type": "module",
"scripts": {
"build": "unbuild",
"prepack": "unbuild"
},
"exports": {
".": {
"import": "./dist/index.mjs",
"require": "./dist/index.cjs"
}
},
"main": "./dist/index.cjs",
"types": "./dist/index.d.ts",
"files": ["dist"]
}Note You can find a more complete example in unjs/template for project setup.
Build with unbuild:
npx unbuild
Configuration is automatically inferred from fields in package.json mapped to src/ directory. For more control, continue with next section.
Create build.config.ts:
export default { entries: ["./src/index"], };
You can either use unbuild key in package.json or build.config.{js,cjs,mjs,ts,mts,cts,json} to specify configuration.
See options here.
Example:
import { defineBuildConfig } from "unbuild"; export default defineBuildConfig({ // If entries is not provided, will be automatically inferred from package.json entries: [ // default "./src/index", // mkdist builder transpiles file-to-file keeping original sources structure { builder: "mkdist", input: "./src/package/components/", outDir: "./build/components", }, ], // Change outDir, default is 'dist' outDir: "build", // Generates .d.ts declaration file declaration: true, });
Or with multiple builds you can declare an array of configs:
import { defineBuildConfig } from "unbuild"; export default defineBuildConfig([ { // If entries is not provided, will be automatically inferred from package.json entries: [ // default "./src/index", // mkdist builder transpiles file-to-file keeping original sources structure { builder: "mkdist", input: "./src/package/components/", outDir: "./build/components", }, ], // Change outDir, default is 'dist' outDir: "build", /** * * `compatible` means "src/index.ts" will generate "dist/index.d.mts", "dist/index.d.cts" and "dist/index.d.ts". * * `node16` means "src/index.ts" will generate "dist/index.d.mts" and "dist/index.d.cts". * * `true` is equivalent to `compatible`. * * `false` will disable declaration generation. * * `undefined` will auto detect based on "package.json". If "package.json" has "types" field, it will be `"compatible"`, otherwise `false`. */ declaration: "compatible", }, { name: "minified", entries: ["./src/index"], outDir: "build/min", rollup: { esbuild: { minify: true, }, }, }, ]);
In build.config.ts
import { defineBuildConfig } from "unbuild"; export default defineBuildConfig({ rollup: { esbuild: { tsconfigRaw: { compilerOptions: { experimentalDecorators: true, }, }, }, }, });
import { defineBuildConfig } from "unbuild"; export default defineBuildConfig({ sourcemap: true, });
- Clone this repository
- Enable Corepack using
corepack enable(usenpm i -g corepackfor Node.js < 16.10) - Install dependencies using
pnpm install - Run interactive tests using
pnpm dev