/netlify-lambda

Helps building and serving lambda functions locally and in CI environments

Primary LanguageJavaScript

Netlify Lambda CLI

This is a small CLI tool that helps with building or serving lambdas built with a simple webpack/babel setup.

The goal is to make it easy to work with Lambda's with modern ES6 without being dependent on having the most state of the art node runtime available in the final deployment environment and with a build that can compile all modules into a single lambda file.

Usage

Netlify lambda installs two commands:

netlify-lambda serve <folder>
netlify-lambda build <folder>

Both depends on a netlify.toml file being present in your project and configuring functions for deployment.

The serve function will start a dev server and a file watcher for the specified folder and route requests to the relevant function at:

http://localhost:9000/hello -> folder/hello.js (must export a handler(event, context callback) function)

The build function will run a single build of the functions in the folder.

Webpack Configuration

By default the webpack configuration uses babel-loader to load all js files. Any .babelrc in the directory netlify-lambda is run from will be respected. If no .babelrc is found, a few basic settings are used.

If you need to use additional webpack modules or loaders, you can specify an additional webpack config with the -c option when running either serve or build.

The additional webpack config will be merged into the default config via webpack-merge's merge.smart method.

License

MIT