# aws-samples/lambda-refarch-webapp

The Web Application reference architecture is a general-purpose, event-driven, web application back-end that uses AWS Lambda, Amazon API Gateway for its business logic. It also uses Amazon DynamoDB as its database and Amazon Cognito for user management. All static content is hosted using AWS Amplify Console.

Repository: https://github.com/aws-samples/lambda-refarch-webapp
Canonical: https://ross.abutalabs.com/products/lambda-refarch-webapp
Homepage: https://aws.amazon.com/lambda/web-apps/
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: serverless, lambda, aws, aws-lambda, amplify, dynamodb
Archived: true
Last push: 2023-04-10T21:31:19+00:00

## Health v2 (maintenance only)
Score: 10/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 3993, "days_push": 1241, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: archived
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1585, forks 909 (observed 2026-08-28T04:05:07.575562+00:00)

## What it is
An AWS serverless reference architecture implementing a general-purpose event-driven web application backend using Lambda, API Gateway, DynamoDB, and Cognito, with static frontend hosting on AWS Amplify Console. It ships as a deployable To Do example app with an AWS SAM template.

## Use cases
- build a serverless web app backend on AWS
- learn how to wire Lambda with API Gateway and DynamoDB
- add user registration and authentication with Cognito
- deploy a full-stack app with an AWS SAM template
- host a React static site on AWS Amplify Console
- use a reference architecture for event-driven REST APIs

## When to choose
- you want a proven AWS-native serverless blueprint to start from
- you need JWT-based user auth and per-user data isolation out of the box
- you prefer infrastructure-as-code deployment via SAM
- you're evaluating serverless patterns for a small-to-medium web backend

## When to avoid
- you're not deploying on AWS
- you need long-running compute or relational databases
- you want a production application rather than a reference example
- you need frameworks outside the Lambda/API Gateway/DynamoDB ecosystem

## Facets
- artifact type: application
- maturity: maintenance
- function: web-framework, auth, api-framework, database, deployment, infrastructure-as-code
- domain: web-development, cloud-computing, developer-tools, apis
- platform: cloud, serverless
- tags: aws-lambda, api-gateway, dynamodb, cognito, aws-amplify, aws-sam, reference-architecture, todo-app, react, event-driven, serverless, nodejs, web-server, docker

## Member repositories
- aws-samples/lambda-refarch-webapp (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:07.575562+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:55:31.401701+00:00, confidence not recorded.
  - readme: https://github.com/aws-samples/lambda-refarch-webapp (fetched 2026-08-28T04:05:07.575562+00:00, sha 8d5c0f71cb0f)
  - homepage: https://aws.amazon.com/lambda/web-apps/ (fetched 2026-08-29T11:26:25.038628+00:00, sha d1a62cc650b6)
  - site_page: https://aws.amazon.com/getting-started?nc2=h_dsc_aa_gs (fetched 2026-08-29T11:26:25.050387+00:00, sha f35fd0664950)
  - site_page: https://aws.amazon.com/about-aws/global-infrastructure?nc2=h_dsc_aa_gi (fetched 2026-08-29T11:26:25.052099+00:00, sha 79a446e5fbd1)
  - site_page: https://aws.amazon.com/products/developer-tools/agent-toolkit-for-aws?nc2=h_dsc_ex_s5 (fetched 2026-08-29T11:26:25.047853+00:00, sha 3cc21b596f92)
  - site_page: https://aws.amazon.com/pricing?nc2=h_pr_hub (fetched 2026-08-29T11:26:25.053838+00:00, sha e2abd01d7981)
  - site_page: https://aws.amazon.com/savingsplans?nc2=h_pr_sp (fetched 2026-08-29T11:26:25.055647+00:00, sha 9ff3c7ad93e0)
  - site_page: https://aws.amazon.com/s3/pricing?nc2=h_pr_s3 (fetched 2026-08-29T11:26:25.057366+00:00, sha 97bbf99c3793)
  - site_page: https://aws.amazon.com/bedrock/pricing?nc2=h_pr_br (fetched 2026-08-29T11:26:25.060802+00:00, sha 4ccc538a3696)
  - site_page: https://aws.amazon.com/rds/pricing?nc2=h_pr_rds (fetched 2026-08-29T11:26:25.062407+00:00, sha 538280f30c8a)
- Data as of 2026-08-30T08:39:29.467469+00:00.