Skip to content

Latest commit

 

History

History
111 lines (78 loc) · 4.14 KB

README.md

File metadata and controls

111 lines (78 loc) · 4.14 KB

Serverless Stack + Prisma - Starter Kit

What is this?

If you want to build a serverless app with AWS CDK, Lambda, and Postgres, this is the template for you.

You can click "Use this template" button in GitHub to fork this repo. You can merge in improvements in this repo to your project over time.

Clone your copy of this template, then do a search and replace for "myapp" to give it a name.

Quickstart

Prerequisites

Assumes you have Node 20 installed and AWS credentials configured.

Setup

Edit sst.config.ts and set your default AWS profile and region.

npm i -g pnpm  # install pnpm globally
pnpm i  # install dependencies + generate types from DB and GQL schemas
pnpm commit-hooks # install commit hooks for linting and formatting (optional)
pnpm db:migrate  # run DB migrations
pnpm dev  # start AWS local dev environment
pnpm dev:web  # start NextJS frontend dev server

Config

Set your default AWS profile and region in sst.config.ts.

Edit .env or .env.$stage to set infrastructure vars.

Features

All features are optional, delete what you don't need.

Click links to learn more and view documentation.

Package scripts

Please see package.json scripts for more.

Start live backend dev server with AWS

pnpm dev

Start Nextjs frontend dev server

pnpm dev:web

Run/generate DB migrations locally

pnpm db:migrate

Just watch and perform type-checking

pnpm watch

Deploy to your AWS environment

pnpm deploy

Deploy to specific AWS environment (region/profile)

pnpm deploy --region eu-west-1 --profile dev

All SST/CDK commands

pnpm exec sst
pnpm exec cdk