Getting started

Zero to running in eight steps.

Requirements

You need Node 20+, a Postgres database and a Stripe account.

node -v   # v20 or newer

Unzip

Unzip the download and move into the folder.

unzip shipember.zip -d my-app
cd my-app

Install

Install dependencies.

npm install

Set up .env

Copy the example file. Add your database URL, auth secrets and Stripe keys.

cp .env.example .env

Migrate and seed

Create the tables, then add seed data.

npx prisma migrate dev
npx prisma db seed

Stripe webhook

Forward events to your local server with the Stripe CLI. Copy the signing secret it prints into .env.

stripe listen --forward-to localhost:3000/api/webhooks/stripe

Run locally

Start the dev server and open localhost:3000.

npm run dev

Deploy to Vercel

Push to GitHub, import the repo in Vercel, and add the same environment variables. Then add your live webhook URL in the Stripe dashboard.

npx vercel --prod