JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 40559
  • Score
    100M100P100Q149718F
  • License MPL-2.0

Serverless plugin to allow use inside a JS monorepo

Package Exports

  • serverless-plugin-monorepo

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (serverless-plugin-monorepo) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

serverless-plugin-monorepo

JavaScript Style Guide

A Serverless plugin design to make it possible to use Serverless in a Javascript mono repo with hoisted dependencies, e.g. when using Yarn Workspaces.

This plugin alleviates the need to use nohoist functionality by creating symlinks to all declared dependencies. Development dependencies are deliberately NOT linked so these will not be packaged into the resulting archive.

Butterwire uses Yarn workspaces and we created this plugin to improve our development experience. Not using nohoist saves wasting disk space and also accidentally including development dependencies in our packaged functions.

Note, this package will only work on operating systems that support symbolic links!

Installation

yarn add --dev serverless-plugin-monorepo
# or using NPM
npm install --dev serverless-plugin-monorepo

Currently this plugin requires Node V8+. If there is interest in support older versions then trans-compilation with Babel could be added.

Usage

Add the plugin to your serverless.yml file:

plugins:
  - serverless-plugin-monorepo

The plugin listens for package lifecycle events. Prior to Serverless packaging up the service, it will scan the package.json file for dependencies and ensure that all dependencies (including transitive dependencies) are symlinked in node_modules.

Hence when Serverless creates the archive, it will follow the symlinks and all dependencies will be added as expected. Development/peer dependencies are ignored.

Contributing

We welcome issue reports and pull requests!

There is a small run script which will launch Node V8 in a Docker container which you may find useful for development purposes.

Note we are using StandardJS and you can run the lint tool via yarn lint which will attempt to automatically issues like spacing etc.

Copyright Butterwire Limited 2018