# Build Lambda Layer
[](https://www.npmjs.com/package/build-lambda-layer)
[](https://github.com/yowainwright/build-lambda-layer)
### Builds Awesome Node Lambda Layers with Control! 🕹
_Build Lambda Layer_ is a utility CLI for building AWS Lambda Layers with control for AWS Node Lambda projects.
---
## Why is this written?
_Build Lambda Layer takes complexity out of building lambda layers!_
---
\+ Monorepo support
\+ The ability to ignore and add dependencies at run time
\+ Easy json configuration!
---
## How does it does it work?
By running:
```sh
build-layer
```
_Build Lambda Layer_ will:
- install all `package.json` dependencies to ``, and
- zip it up to be uploaded to AWS 🚀
---
#### Additionally, _Build Lambda Layer_ works with monorepos!
A key additional feature that Build Lambda Layer provides is that it works with monorepos!
By running:
```sh
build-layer my-lambda-layer --files 'packages/**/package.json'
```
_Build Lambda Layer_ will:
- install all `package/**/package.json` dependencies to your lambda layer, and
- zip it up to be uploaded to AWS
---
#### Ignore and include the dependencies you want!
_Build Lambda Layer_ supports specificity with `ignore` and `include` options.
By adding a `"lambdaLayer"` object to a `package.json` file you're building from, you can specify packages to `ignore` and `include`:
```json
{
"buildLambda": {
"ignore": ["@types/aws-lambda"],
"include": {
"aws-lambda": "latest"
}
}
}
```
You can also add a `lambdaLayerrc` file to your project root if you want to preserve your `package.json` file.
```json
{
"ignore": ["@types/aws-lambda"],
"include": {
"aws-lambda": "latest"
}
}
```
---
#### Be _really_ selective with your installs
There is nothing stopping you from creating your own dependency object to install.
Add a `.json` file to your project root:
```json
{
"dependencies": {
"aws-lambda": "latest"
}
}
```
And run:
```sh
build-layer my-lambda-layer --files '.json'
```
---
That's it! 🎉
Save yourself the time and effort of building Lambda Layers and let _Build Lambda Layer_ do it for you!
---
### Install
```sh
pnpm install build-lambda-layer
```
---
### CLI API
```sh
Usage: build-layer [options]
Build Lambda Layer, Build node awesome lambda layers with controls 🕹
Arguments:
dir lambda layer directory to build to
Options:
--architectures [architectures...] architectures for deployment to AWS
--bucket bucket to deploy to using AWS
-c, --config path to a config file
--deploy deploy your lambda layer
-n, --name lambda layer name
--debug enable debugging
-f, --files [files...] file glob pattern
-i, --ignore [ignore...] ignore glob pattern
--isTesting enable running fn tests w/o overwriting
--noZip don't zip lambda layer
-o, --output