JAWS: The Server-less Framework V1 (BETA)

Welcome to JAWS V1 BETA. Many things are broken. Please provide fixes and feedback :)

Goals:

• No Servers: The JAWS back-end is comprised entirely of AWS Lambda Functions. You can develop/update/configure each separately without affecting any other part of your application. Your app never goes down. There is no app. Only individual lambda functions can go down.
• Scale Infinitely: A back-end comprised of Lambda functions comes with a ton of concurrency.
• Be Cheap As Possible: Lambda functions run only when they are called, and you pay only when they are run.
• All Lambda Runtimes While first release is nodejs only, we plan on adding supoport for all languages. This means each lambda in your JAWS project can be coded in the lang that best suites the problem.
• API Gateway Auto-Deploy Creates your API endpoints for you on API Gateway.
• Multi-stage & Multi-Region: Define stages for your project, and multiple regions with a stage. Driven by CloudFormation.

Architecture

Graphics coming soon...

Quick Start

This guide gets you started quickly. Later, check out the best practices guide in our wiki for tips on security and more.

Install

These 3 steps will only have to be done once across all your JAWS projects in an AWS account:

• Setup an AWS account and create an administrative user
• Create S3 bucket that will hold your enviornment variable files. Why?
• npm install jaws-framework -g

Hit the ground running

• Create a new project in your current working directory:

jaws new project

• Generate a lambda function skeletion and corresponding API gateway endpoint config:

cd <proj-name>; jaws new action

• Deploy generated lambda:

  TODO: do we put dash command here?

• Optionally deploy your API gateway:

  • Configure jaws.json endpoint attribute in <funcName> dir
  • cd back/lambdas/<funcName>; jaws deploy api

Where do I go from here?

Check out our docs and wiki, especially the best practices and FAQ pages

Once you become familar with JAWS, you can read the JAWS plug-in module guide to start contributing JAWS modules to the community.

How can I help?

Check out our v1.1 roadmap doc for what we need help with.

Please check out our CONTRIBUTING.md for coding and PR guidelines.