module-replacements

As part of the community e18e effort, this project
provides a collection of module replacements (i.e. possible alternative
packages).

We provide two things:
- Manifests (mappings of modules to their possible replacements)
- Documentation for more complex replacements

List of replacements

You can find a list of replacements in the
modules readme.

Tools

Some tools consume the lists of modules in this repository:

| Name | Description |
| -- | -- |
| eslint-plugin-depend | ESLint plugin to detect possible replacements |

Manifests

The manifests can be used via the module-replacements npm package.

We provide three manifests:

- All (includes every manifest)
- Native replacements
- Micro utility replacements
- Preferred replacements

$3

You can install this package via npm:

``sh
npm i -S module-replacements
`

You can then import the manifest of your choice:

`ts
import {nativeReplacements} from 'module-replacements';
`

The manifests are also available directly in the manifests/ directory
of the package (e.g. node_modules/module-replacements/manifests/native.json`).

$3

These are modules which can now be replaced by native functionality.

For example, pseudo-polyfills which provide functionality of widely available
platform features can be replaced by their platform equivalents.

Similarly, features which did not exist at the time but have now existed in
the platform for many years, so no longer need a dependency.

$3

This is a more opinionated list of modules considered to be 'micro utilities' -
very small utilities which could possibly be replaced with native equivalents
or removed entirely.

$3

This is a very opinionated list of modules with preferred replacements. Often
these replacements are much lighter or more modern than the modules they are
replacing.

Sometimes these may also be actively maintained forks of older, unmaintained
source packages.

Contributing

If you would like to add a replacement mapping to one of the manifests, please
open an issue where this can be discussed.

Keep in mind, very newly available native features are unlikely to join the
list since they are not widely available yet.