An open API service indexing awesome lists of open source software.

https://github.com/alexisvincent/systemjs-config-builder

Generate SystemJS config files from node_modules
https://github.com/alexisvincent/systemjs-config-builder

jspm node-modules systemjs systemjs-config-builder

Last synced: 9 months ago
JSON representation

Generate SystemJS config files from node_modules

Awesome Lists containing this project

README

          

# SystemJS Config Builder
Generate SystemJS config files from node_modules

## Overview
The easiest way to include modules in SystemJS is *currently* through JSPM. This project aims to provide an alternative, by leveraging the deterministic installs of Yarn (also works with npm) and generating config files to explain to SystemJS how to resolve modules from `node_modules`.

## Roadmap

- [x] Trace node_modules and build registry
- [x] Generage compatability configs for packages
- [x] Generate valid SystemJS config file
- [x] Make sure loading React.JS works
- [x] Cache registry (to speed up subsequent generations)
- [x] Use own @node polyfills. See [#1](https://github.com/alexisvincent/systemjs-config-builder/issues/1) for progress
- [x] Respect `jspmPackage: true`
- [x] Perform path optimisations (nm: -> node_modules), for smaller configs
- [ ] Fully support npm resolve algorithym (upper node_module and single dep node_modules)
- [ ] Allow simple local overrides
- [ ] Use JSPM overrides
- [ ] Allow dependency filtering (so we don't include deps meant for just the server)
- [ ] Provide CLI flag to optimize generated.config.js
- [ ] Allow configurability
- [ ] Make more robust

Currently, given this [package.json](./test/babel/package.json),
SystemJS Config Builder generates this [config](./test/babel/generated.config.js).

## Usage
### [Example Project (with usage instructions)](./example)
You can test the generation via the cli in [systemjs-tools](https://github.com/alexisvincent/systemjs-tools).

`yarn global add systemjs-tools`

add SystemJS @node browser polyfills

`yarn add systemjs-nodelibs`

and generate the config

`systemjs config`

optionally you can also add a postinstall hook to do this automatically

package.json
```json
{
"scripts": {
"postinstall": "systemjs config"
}
}
```

## Thanks
Thanks to [Juha Järvi](https://github.com/jjrv) for helping me flesh out this idea and for the discussions regarding
his awesome [cbuild project](https://github.com/charto/cbuild).