Skip to content
Switch branches/tags
This branch is up to date with master.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Greenkeeper badge npm version Build Status

Yeoman generator to create Lerna ( Typescript monorepos, for multiple Serverless/Lambda functions.


Make sure you have Nodejs 8.10 LTS or above, along with Yarn. See 'Installation detail' section below for more info.

First, install Yeoman and generator-mono-serverless using npm (we assume you have pre-installed node.js).

npm install -g yo
npm install -g generator-mono-serverless

Then generate your new project:

yo mono-serverless

Adding serverless functions

Inside your generated repo, use:

yarn generate-package

..and follow the prompts. This will give you the scaffolding for a new serverless function.

You will be prompted for:

  • lambda package name, version and npm namespace
  • dynamodb tablename (optional creation and binding)
  • whether to enable API gateway aliases
  • whether to enable custom domain names

Custom domain names can be used to surface api endpoints on a domain name managed in a Route53 zone you can control, and should have a predeployed AWS managed TLS certificate. Base path will be the package name. View serverless.yml for details.

Note that you can generate swagger documentation for your functions using annotations in your serverless.yml files.


The following scripts are used to manage functions.

test offline

Inside new package run this, then browse to url shown.

yarn sls-offline

test end to end

Inside new package run this, then browse to url shown.

yarn sls-deploy

remove lambda

Inside new package run this.

yarn sls-remove

if API gateway aliases are enabled, use this first:

yarn sls-remove-alias --alias=<stage|alias>

tail lambda logs

Inside new package run this.

yarn sls-logs --function=[functionName]

Installation detail

More detailed steps.

install nvm and node

curl -o- | bash
nvm install 8
nvm use 8

install yarn

install yeoman

npm install -g yo

install serverless

npm install -g serverless

aws sdk setup

Best to setup the aws cli.

..or just configure serverless..

serverless config credentials --provider aws --key AKIAIOSFODNN7EXAMPLE --secret wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

add AWS_REGION=ap-southeast-2 to ~/.aws/credentials

install mono serverless generator

npm install -g generator-mono-serverless

run generator to create repo

yo mono-serverless

inside new repo run

yarn generate-package

At this point you should be ready generate more serverless packages and start coding your functions.


See for some example functions seeded by this generator.


Yeoman generator to create monorepos, for multiple serverless functions.




No packages published