pack-up is a set of simple tools for creating interoperable CJS & ESM packages.
Setting up a new interoperable project is as easy as doing:
npx @strapi/pack-up@latest init my-package
cd my-package
npm run build
Just a small bit about us:
- Vite: We support
vite
as a JS bundler, no need to install it though as it's preprepared with helpful defaults ready to tackle all projects. - Concise: It's all based off your
package.json
so you know the interoperable aspect is correctly set up and there's no requirement for another config! - Flexible: Need more customisation or to bundle a package not declared in your exports? Use the config file to dictate separate bundles & options.
If you're setting up a brand new package we recommend you use the init
command to get started:
npx @strapi/pack-up@latest init my-package
But if you're adding this to an existing project then just install like every other dependency:
npm install @strapi/pack-up@latest --save-dev
And to help you ensure your package is set up correctly run the check
command:
npm run pack-up check
Run pack-up -h
for more information on CLI usage.
Creates a new package at the given path, by default uses the inbuilt template sensible options for your package to choose from.
--template [path]
– path to a custom template of typeTemplateOrTemplateResolver
.
Builds your current package based on the configuration in your package.json
and packup.config.ts
(if applicable).
--minify
– minifies the output (defaultfalse
).--sourcemap
– generates sourcemaps for the output (defaulttrue
).
Checks your current package to ensure it's interoperable in the real world. In short, validates the files in your dist have been produced as we expect & then esbuild
can actually build, using your exported code.
Watches your current package for changes and rebuilds when necessary.
@strapi/pack-up
by default reads its configuration from your package.json
. But sometimes you need more flexibility, to do this you can create a packup.config.ts
file in the root of your package.
// packup.config.ts
import { defineConfig } from '@strapi/pack-up';
export default defineConfig({
minify: true,
sourcemap: false,
externals: ['path', 'fs'],
});
- Type:
ConfigBundle[]
An array of entry points to bundle. This is useful if you want to bundle something that should not be exported by the package, e.g. CLI scripts or Node.js workers.
- Type:
string
The path to the directory to which the bundled files should be written.
- Type:
Record<string, Export>
Overwrite or amend the parsed exports from your package.json
.
- Type:
string[]
An array of modules that should not be bundled but instead be resolved at runtime, this is by default the dependencies listed in your package.json
(excluding devDeps).
- Type:
boolean
Whether to minify the output or not.
- Type:
PluginOption[] | (({ runtime }: { runtime: Runtime }) => PluginOption[]);
An array of Vite plugins to use when bundling, or optionally a function that returns an array of plugins based on the runtime.
- Type:
boolean
Instead of creating as few chunks as possible, this mode will create separate chunks for all modules using the original module names as file names.
- Type:
boolean
Whether to generate sourcemaps for the output or not.
- Type:
Runtime
The transpilation target of the bundle. This is useful if you're bundling many different CLIs or Node.js workers and you want them to be transpiled for the node environment.
- Type:
string
Path to the tsconfig file to use for the bundle, defaults to tsconfig.build.json
.