This is a full stack webapp for starters who want to leverage the power of AWS serverless services!
Features include:
- Express API endpoint (both with and without authentication)
- React.js frontend (assets are delivered via CDN)
- E-mail authentication
Here is the architecture of this kit. We use:
- Amazon DynamoDB, a serverless scalable NoSQL database
- Amazon API Gateway HTTP API + AWS Lambda to build serverless API endpoint (
serverless-express) - Amazon CloudFront + S3 to distribute frontend assets (React.js, Amplify libraries, MUI)
- Amazon Cognito for authentication. By default, you can sign in/up by email, but you can federate with other OIDC providers such as Google, Facebook, and more with a little modification.
Since it fully leverages AWS serverless services, you can use it with high cost efficiency, scalability, and almost no heavy lifting of managing servers! In terms of cost, we further discuss how much it costs in the below #Cost section.
To show how this kit works, we include a sample web app to write and store your memos. With this sample, you can easily understand how each component works with other ones, and what the overall experience will be like.
You can further improve this sample or remove all the specific code and write your own app. But first let's deploy this sample as-is!
To implement your own features, you may want to add frontend pages or backend API endpoints. The frontend is an ordinary React.js application, so you can follow the conventional ways to add pages to it. As for backend, there are step-by-step guides to add features in backend/README.md, so please follow the guide.
If you want to add another authentication method such as Google or Facebook federation, you can follow this document: Add social sign-in to a user pool.
To develop frontend or backend locally, please refer to each README.md in the subdirectories:
API Gateway, Lambda, SQS, CloudFront, and S3 offer free tier plans, which allows you to use those services almost freely for small businesses. Up to one million requests per month, most of the costs related to those services are free. See this page for more details.
DynamoDB is billed basically by how many read and write counts processed. See this page for the current prices. DynamoDB provisioned capacity mode also offers free tier plans, so if you want to pay the minimal cost, you can switch the billing mode.
Other costs will be derived from data transfer and Elastic Container Repository (used for Docker Lambda). Although it usually does not cost much compared to other services, you may want to continuously monitor the billing metrics. Please refer to the document to set CloudWatch alarm for AWS charges.
This library is licensed under the MIT-0 License. See the LICENSE file.