# ipjs

**Repository Path**: mirrors_rvagg/ipjs

## Basic Information

- **Project Name**: ipjs
- **Description**: Universal JavaScript Build and Packaging
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-12-16
- **Last Updated**: 2026-03-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Universal JavaScript Build and Packaging

This is a toolchain for the next phase of JavaScript development. It
enables developers to write JavaScript modules in ESM that work
universally across many environments (Node.js import, Node.js require,
Browser, Deno, etc).

You start by just writing a standard ESM module. You'll need to include
`"type": "module"` in your package.json, as well as a `"main"` entry
point or an [export map](https://nodejs.org/api/esm.html#esm_package_entry_points).

```
npx ipjs build
```

This will build a package in the `dist` directory that has different
versions of your files compiled for different environments and a
new package.json file that exposes all of these files to the correct
Node.js and compiler entry points.

That's it ;)

You can also compile your tests.

```
npx ipjs build --tests
```

Note: You'll need to use "named self imports", `import mymodule from "mymodule"`,
in your tests so that we can compile different CJS versions of those tests for
Node.js and the browser.

You can publish to by either running `npm publish` in the dist directory or using:

```
npx ipjs publish
```

## Requirements

There's a few Node.js and ESM features you need to stick to using and a few you need
to avoid. Some are because there just isn't a very good way to provide consistent representations
and some are because we need some more explicit information about your library in order
to detect the dependency tree and built it successfully.

### Do not use mixed default default and named exports/imports

### Only export individual files in export map (no directories or pattern matching)