Skip to content

A template repository of a serverless webapp deployed to AWS via GitHub Actions

Notifications You must be signed in to change notification settings

stratiformdigital/cdk-webapp

Repository files navigation

cdk-webapp

A cloud-native, serverless form submission application deployed to AWS with SST and the AWS CDK.

Docs Slack Dependabot code style: prettier semantic-release: angular


Please visit the cdk-webapp documentation site for complete documentation. This README is just an introduction.


Overview

The cdk-webapp project is a template for a serverless, cloud native, form submission application. A react frontend is presented to the user by way of S3 and Cloudfront. Users submit form data and blob uploads (PDFs, etc.) to the application. Form data goes directly to an API Gateway backed by lambda, and blob data goes directly to an S3 bucket where it is virus scanned. A DynamoDB Stream, a Lambda, and SES are used to send confiration of user submission. All of this is protected by AWS Cognito.

The actual application is fairly 'hello world', but the repository support and configuration is full featured. This is by design, to allow for simpler project creation from the template. Full CI/CD support with GitHub Actions, automated security scanning, docs site in GitHub Pages, PR/Issue templates, infrastructure and application deployment workflows, etc. is all included.

diagram

Contributing

You can check out our current open issues here. Please feel free to open new issues for bugs or enhancements.

Pull requests from forks are being accepted.

License

License: MIT by Stratiform Digital LLC

See LICENSE for full details.