###API There are no servers are included in this stack(!!!). The entire back-end is comprised of Lambda functions. Each API Route points to an individual Lambda function. This way, the code for each API Route is completely isolated, enabling you to develop/update/configure/deploy/maintain that specific code at any time without affecting any other part of your application(!!!). Think of each Lambda function as a "Controller", in traditional MVC structure.

###Lib In JAWS, the Lambda functions are the "Controllers", but the lib folder/module contains re-useable code you would like to use across all of your Lambda functions ("Models", configs, etc.).

Since Lambda can be slow to initialize on cold-starts (after ~5 mins of inactivity), this module is designed so that you do not have to require all of its code, but instead you can require in only the code that your Lambda function needs. For example:

// This only loads code needed for the User Model
var ModelUser = require('jaws-lib').models.User;

While developing, make sure you create an npm sym-link between this module and all of your Lambda functions. This way, all of the changes in the lib folder will be instantly available in every one of your Lambda functions when you run/test them locally.

###CLI (Command Line Interface) This stack comes with its own command line interface to help you test your API Lambda Functions locally and deploy them. The commands are as follows:

Run A Lambda Function Locally Make sure you in the root folder of your Lambda function (api/users/signup) and enter this:

$ jaws run

Deploy A Lambda Function Make sure you in the root folder of your Lambda function (api/users/signup) and enter this:

$ jaws deploy

##Starring

Javascript:

Node.js (in AWS Lambda functions)
jQuery (in your front-end site)

AWS Services:

DynamoDB - Managed, NOSQL data storage
Lambda - Build worker tasks that you can spawn and scale infinitely.
API Gateway - Launch an API with urls pointing to your Lambda functions
S3 - Host static assets for your site here

Other:

JSON Web Tokens

##Set-Up

AWS Set-Up

Create an AWS account, if you don't have one already
Create an IAM user

Creating New API Routes/Lambda Functions

Copy and paste the api/template folder somewhere in the api folder and rename it.
To require the lib into your Lambda functions, we recommend creating an npm link. Cd into your lib folder, run npm link, then cd into your lambda function's folder and run npm link jaws-lib.

##Resources

Languages

JavaScript 97.1%

Go 1.2%

Java 0.8%

Shell 0.4%

Python 0.2%