.
├── lambdas
│   ├── lambda-one
│   │   ├── dist
│   │   ├── package.json
│   │   └── src
│   └── lambda-two
│       ├── dist
│       ├── package.json
│       └── src
├── lerna.json
├── package.json
├── common
│   ├── domain-model
│   │   ├── package.json
│   │   └── src
│   └── logging
│       ├── package.json
│       └── src
├── terraform
│   ├── deployments
│   │   ├── app
│   │   └── artifact-storage
│   └── modules
│       ├── lambda-function
│       └── rest-endpoint
├── yarn.lock
└── .wavelength.yml

There's a few things to unpack here, so lets break it down:

You must use lerna to build your code, with each function being contained in it's own package. Packages names should follow the convention @my-app/lambda-one.

Each package's build script should create an artifact at dist/<lambda-name>.zip. A handy utility for doing this is lerna-to-lambda.

You should have 2 separate Terraform deployments; one that creates an s3 bucket in which to store your code, and another that creates the actual lambda functions, along with any other required infrastructure (i.e. an API Gateway, IAM roles, etc).

The module that creates the bucket must export the bucket name as an output. Wavelength will read this to figure out where to upload your code.

The names of the lambda functions should match the name of the directory/node package they live in, and be prefixed with your app name, e.g. my-app-lambda-one.

Wavelength requires a .wavelength.yml or .wavelength.json config file in the root of your repo. It supports the following properties:

For the example shown above, this would look like:

projectName: my-app
artifactStorage:
  terraformDir: terraform/deployments/artifact-storage
  outputName: bucket_name

cd terraform/deployments/artifact-storage
terraform apply # Create the artifact bucket
cd ../../..
wavelength upload dev # Build and upload code to S3
cd terraform/deployments/app
terraform apply # Create lambdas
cd ../../..

# Build and upload edited code to S3
wavelength upload dev
# Update lambdas with new code
wavelength update dev

wavelength upload <commit-sha>

terraform apply -ver version="<commit-sha>" -auto-approve

FROM ghcr.io/lewis-od/wavelength:v1.1.0 as wavelength

FROM debian:buster-slim

COPY --from=wavelength /wavelength/dist/wavelength /usr/bin/wavelength

# Other stuff here