Run it locally

This section is for people working on Prood's source. It walks you through installing the monorepo, configuring environment variables, seeding the database, and running every application in development. Opening a store on Prood needs none of this: start with Get started.

PrerequisitesCopy Anchor Link

Optional for full checkout flows:

• Upstash Redis — checkout session storage
• Stripe (or Easypay / Ifthenpay) — a test account. Keys are entered per store in the dashboard, under Integrations

Quick installCopy Anchor Link

git clone <your-repo-url>
cd prood-commerce-platform
pnpm install
cp .env.example .env.local
pnpm env:link
pnpm db:migrate
pnpm db:seed
pnpm dev

After pnpm dev, Turbo starts all apps. Open the gateway at http://localhost:3001: it stands in for prood.com and sends each path to the app behind it, so the dashboard, admin console, checkout, docs and API share one origin, as they do in production.

Each app also listens on its own port (3002 dashboard, 3003 docs, 3004 checkout, 3005 api, 3006 admin), which the gateway rewrites to. Sign in through the gateway: the session cookie belongs to the origin you signed in on, and passkeys are set up for localhost:3001.

Monorepo applicationsCopy Anchor Link

Database scriptsCopy Anchor Link

1. pnpm db:migrate — Applies the versioned migrations in packages/platform/drizzle with drizzle-kit migrate: the commerce tables, the Better Auth tables (user, session, account, organization, agent auth, tenant_domain, integration_config), the prood_app role and the row-level-security policies. Already-applied migrations are skipped, so re-running it is a no-op.
2. pnpm db:seed — Seeds the demo store: the org_demo organization (slug prood-demo), European countries, the demo catalog in EUR, and an admin user from ADMIN_EMAIL / ADMIN_PASSWORD when those env vars are set. Idempotent.

The storefront resolves the demo store from its host: open http://prood-demo.localhost:3000.

Shared environmentCopy Anchor Link

All apps read from a single root .env.local. Run pnpm env:link to generate apps/*/.env.local from it. The script copies the root file and writes the local one-domain URLs into each app (NEXT_PUBLIC_DASHBOARD_URL=http://localhost:3001/dashboard, CHECKOUT_URL=http://localhost:3001/pay, the passkey settings for localhost, and so on), so it overrides any URL variable in the root file. Run it again after you change the root file.

Documentation mapCopy Anchor Link

Default demo credentialsCopy Anchor Link

After seeding, the platform creates an admin user if ADMIN_EMAIL and ADMIN_PASSWORD are set in .env.local. Use these to sign in to the dashboard at http://localhost:3001/dashboard.

The seeded catalog belongs to the org_demo organization. The storefront serves it at prood-demo.localhost:3000 (the {slug}.{NEXT_PUBLIC_PLATFORM_DOMAIN} host).