---id: local-devtype: guideowner: justindescribes:  - wrangler.jsonc  - workers/*/wrangler.jsonc  - scripts/seed.sqlreviewed: 2026-10-12---# Running the shop locallyYou need Node 24 and, for checkout, a Stripe account in test mode. Everything else runs in wrangler's local mode.## The API```bashnpm installnpm run db:migrate          # applies migrations/ to the local D1npm run db:seed             # six products, one of them out of stockecho 'ADMIN_TOKEN=dev-admin-token' > .dev.varsnpm run dev                 # storefront-api on localhost:8787````curl localhost:8787/products` lists all six; the candle is out of stock, so adding it to a cart fails. Add `STRIPE_SECRET_KEY` (a test mode secret key) to `.dev.vars` to try checkout.Image URLs point at `IMAGES_URL` from `wrangler.jsonc`. Locally the upload works but the URL does not resolve, because the custom domain serves the production bucket ([[product-images]]). Set `IMAGES_URL` in `.dev.vars` to another origin if you want working links.## The other WorkersEach has its own config, so run it in a second terminal from the repository root:```bashnpx wrangler dev -c workers/stripe-webhook/wrangler.jsonc --port 8788npx wrangler dev -c workers/fulfilment/wrangler.jsonc --port 8789```wrangler connects the `ORDERS` service bindings to the storefront-api you started first, and the `order-events` queue between storefront-api and fulfilment. See [[payment-webhook]] for forwarding Stripe's test events and [[fulfilment]] for the warehouse settings.## CronThe unpaid order expiry runs on a cron trigger. To run it once by hand:```bashnpx wrangler dev --test-scheduledcurl 'localhost:8787/__scheduled?cron=*/5+*+*+*+*'```## TestsThe tests need none of this; see [[testing]].