/serverless-stack

Serverless Stack Toolkit allows you to build serverless apps using CDK.

Primary LanguageJavaScriptMIT LicenseMIT

Serverless Stack Toolkit (SST)

Serverless Stack Toolkit (SST)

Slack npm Build status

Serverless Stack Toolkit (SST) is an extension of AWS CDK that:

sst start

SST also supports deploying your CloudFormation stacks asynchronously. Seed natively supports concurrent asynchronous deployments for your SST apps. And SST deployments on Seed are free!

SST also comes with a few other niceties:

  • Automatically lints your code using ESLint
  • Runs your unit tests using Jest

Behind the scenes, SST uses a lightweight fork of AWS CDK to programmatically invoke the various CDK commands.

Quick Start

Create your first SST app.

$ npx create-serverless-stack@latest my-sst-app
$ cd my-sst-app
$ npx sst start

Live Lambda Development

The sst start command starts up a local development environment that opens a WebSocket connection to your deployed app and proxies any Lambda requests to your local machine. This allows you to:

  • Work on your Lambda functions locally
  • Supports all Lambda triggers, so there's no need to mock API Gateway, SQS, SNS, etc.
  • Supports real Lambda environment variables and Lambda IAM permissions
  • And it's fast. There's nothing to deploy when you make a change!

Read more about Live Lambda Development.

Documentation

Check out the SST docs

Future Roadmap

SST is being actively developed. Check out the public SST roadmap here. And make sure to star the repo and subscribe to updates.

Contributing

Check out our roadmap and join our Slack to get started.

  • Open a new issue if you've found a bug or have some suggestions.
  • Or submit a pull request!

Running Locally

To run this project locally, clone the repo and initialize the project.

$ git clone https://github.com/serverless-stack/serverless-stack.git
$ cd serverless-stack
$ yarn

Run all the tests.

$ yarn test

To run the docs site.

$ cd www
$ yarn start

Community

Follow us on Twitter, join us on Slack, post on our forums, and subscribe to our newsletter.

Thanks

This project extends AWS CDK and is based on the ideas from Create React App.

Brought to you by Anomaly Innovations; makers of Seed and the Serverless Stack Guide.