upakovka v0.0.1
upakovka
With upakovka(1)
you manage your nodejs monorepo project as a single large npm package.
You have single package.json
and
relative imports between internal modules - a simple structure which every developer and tool understands.
For deployment or publishing you split your codebase into individual packages.
Usage
Create packing.json
file in the project's root directory
{
"outDir": "packages", // output directory where to build individual packages
"packages": [
{
"name": "tool-1", // name of the target package
"js": [ // list of js entry points
"lib/tool-1/main.js"
],
"files": [ // list of non-js files to include into package
{name: "README.md", src: "docs/tool-1/README.md"},
"lib/tool-1/config.txt"
// you don't have to list `.js.map` or `.d.ts` files here,
// they will be included automatically
],
"package_json": { // miscellaneous fields to put into `package.json`
// upakovka(1) will supply defaults for some fields like `.version`, `.author`, `.license`
// based on the content of the project's `package.json`.
"description": "tool-1 is for..."
}
}
]
}
Then just run upakovka
with no arguments, and it will generate specified packages.
How it works
For each package it recursively traverses js files by parsing commonjs require
calls.
It includes each internal module into the target package and
for each external dependency it creates an entry in .dependencies
of package.json
.
Caveats
This is an alpha quality software. Below is a list of issues we hope to fix soon:
- There is no support for
package-lock.json
. - Supports only commonjs modules and ES2018 version of JavaScript
- Although
.d.ts
files corresponding to.js
modules will be included automatically, pure.d.ts
declarations will be omitted. You have to list those manually under.files
. - There is no support for code splitting scenarios where you want to put each file into exactly one package.
Installation
via npm
npm install upakovka