dawson is a serverless web framework for Node.js on AWS (CloudFormation, CloudFront, API Gateway, Lambda). You can use dawson to build and deploy backend code and infrastructure for single-page apps + API, pure APIs or server-rendered pages.

Code Quality Rank: L4
Monthly Downloads: 0
Programming language: JavaScript
License: GNU General Public License v3.0 only
Tags: Web Frameworks     Framework     Web     Aws     Serverless     CloudFormation     Lambda    
Latest version: v0.28.0

dawson-cli alternatives and similar modules

Based on the "Web Frameworks" category.
Alternatively, view dawson-cli alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of dawson-cli or a related project?

Add another 'Web Frameworks' Module




Sorry, this project is not maintained anymore.


Build Status Dependency Status Greenkeeper badge Coverage Status codecov

dawson is a serverless web framework for Node.js on AWS (CloudFormation, CloudFront, API Gateway, Lambda).
You can use dawson to build and deploy backend code and infrastructure for single-page apps + API, pure APIs or server-rendered pages.

npm package

// api.js

import pug from 'pug';
const template = pug.compileFile('template.pug');

export async function greet (event) {
    const name = event.params.path.name
    const age = await getUserAge(name);
    return template({ name, age });
greet.api = {
    path: 'greet/{name}'
$ npm install -g @dawson/dawson-cli
$ dawson deploy


Getting Started Guide, API & CLI Documentation


Examples & Reference Apps

Articles & Tutorials

  1. dawson & React server-side rendering by @hwclass


dawson lets you to deploy your serverless Node.js apps on Amazon Web Services. It requires no boilerplate, no init command and no configuration files. Just write your functions and deploy!

You can write your functions using the latest JavaScript version (babel-preset-latest), including async-await, object-rest-spread etc. Functions can be async and can return Promises. There's also built-in authorization support via API Gateway Custom Authorizers.

Each function has its own IAM Execution Role, so you can define fine-graned IAM Policies.
dawson offers first-class support for Single Page Applications: a CloudFront Distribution will be deployed in front of your app, correctly mapping assets and the API origin, so you don't have to worry about CORS. An AWS WAF WebACL can also be attached to CloudFront.

dawson does not bundle your app with webpack, browserify or rollup, so you'll never have to deal with weird things. Your app's devDependencies are stripped out while deploying, keeping the bundle ZIP small.

dawson uses pure CloudFormation templates, following the infrastructure-as-code principle; it requires no local or remote state files which may go out-of-sync or mistakenly be deleted. You can customize your app's template in every part, e.g.: you can add CloudFormation Resources, modify Properties of Resources created by dawson etc. As a free benefit, you get out-of-the-box support for multiple stages and regions.

Finally, dawson will automatically support HTTPS for custom domains thanks to AWS ACM. Also, if you use Route53 your DNS Zone can be automatically updated.


Using the dawson command you can deploy the infrastructure, inspect logs (in real time, like tail -f) and spin up a full development server so you can run your all locally in an environment will be almost identical to production's. The development server can also run functions locally in response to real AWS Events (S3 Events, DynamoDB Triggers etc.).

$ dawson deploy # deploy your app
$ dawson log -f functionName --follow # get function logs
$ dawson describe # list CloudFormation outputs
$ dawson dev # start a development server



(additionally for each region you'll deploy to, dawson uses a support stack with an S3 Bucket to store Lambda ZIP bundles and CloudFormation templates)


A changelog is maintained in the Releases page.


js-semistandard-style Commitizen friendly

Any contribution is very welcome! You may pick an Issue, fork and start working on that. Should you need any guidance or help please ask :)


Run npm test.

We are currently testing and targeting 100% coverage for functions that are involved in the template generation (src/factories/**.js).


Thanks goes to these wonderful people (emoji key):

<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --> | Simone Lusenti๐Ÿ’ฌ ๐Ÿ“ ๐Ÿ› ๐Ÿ’ป ๐Ÿ“– ๐Ÿ’ก ๐Ÿš‡ ๐Ÿ”Œ ๐Ÿ‘€ ๐Ÿ“ข โš ๏ธ ๐Ÿ”ง โœ… | Alex Casalboni๐Ÿ’ฌ ๐Ÿ› ๐Ÿ’ป ๐Ÿ’ก ๐Ÿ“ข โš ๏ธ ๐Ÿ”ง | Giacomo Consonni๐Ÿ’ป ๐Ÿ“– ๐Ÿ”Œ | Luca Casartelli๐Ÿ’ป ๐Ÿ“– | Chris Matheson๐Ÿ› ๐Ÿ“– | Robert Kistner๐Ÿ› ๐Ÿ’ป | | :---: | :---: | :---: | :---: | :---: | :---: | <!-- ALL-CONTRIBUTORS-LIST:END -->

This project follows the all-contributors specification. Contributions of any kind welcome!

<!-- Contributors START Simone_Lusenti lusentis https://twitter.com/Lanzone31 code infra doc tests example Alex_Casalboni alexcasalboni https://twitter.com/alex_casalboni code answers Giacomo_Consonni giaco9 https://twitter.com/GiacomoConsonni code Luca_Casartelli lcasartelli https://twitter.com/CasartelliLuca code doc Chris_Matheson chrismatheson https://twitter.com/chrismatheson doc Contributors END -->


In case you have an issue, make sure you have updated to the latest version (e.g.: npm i @dawson/dawson-cli@latest), then:

  • search / post on StackOverflow using the dawson tag
  • search / open an issue in this repo
  • contact me on Twitter @Lanzone31



Copyright (C) 2016  Simone Lusenti

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

*Note that all licence references and agreements mentioned in the dawson-cli README section above are relevant to that project's source code only.