/demo-notes-app

Source for the demo notes app in the SST Guide

Primary LanguageJavaScriptMIT LicenseMIT

SST Demo Notes App Seed Status

The Serverless Stack Guide is a comprehensive open source tutorial for building and deploying full-stack apps using serverless and React on AWS.

We create a note taking app from scratch. Using React.js, AWS Lambda, API Gateway, DynamoDB, and Cognito.

Demo App

This repo is a full-stack serverless app built with SST.

  • The stacks/ directory defines our AWS infrastructure using AWS CDK.
  • The packages/ directory contains the Lambda functions that power the CRUD API.
  • The frontend/ directory contains the React app.

It's a single-page React app powered by a serverless CRUD API. We also cover how add user authentication, handle file uploads, and process credit card payments with Stripe.

Usage

Clone this repo.

$ git clone https://github.com/serverless-stack/demo-notes-app

Install dependencies.

$ npm install

This project refers to a .env.local file with a secret that we are not checking in to the repo. Make sure to create one before deploying - https://sst.dev/chapters/handling-secrets-in-sst.html.

Developing Locally

Start the Live Lambda Dev Environment.

$ npx sst dev

Install dependencies for the frontend React app.

$ cd frontend
$ npm install

Start the React local dev environment from the frontend/ dir.

$ npm start

Running Tests

From the project root.

$ npm test

Deploying to Prod

Run this in the project root to deploy it to prod.

$ npx sst deploy

Join the SST community over on Discord and follow us on Twitter.