Quick start

A working store on localhost in about ten minutes.

01Unzip and run the installerFrom the unzipped folder, run node setup.js. It checks Node, installs dependencies, asks for your MongoDB connection string, generates JWT_SECRET and INTERNAL_API_KEY, and asks for your ImageKit or Cloudinary keys — all written into the root .env.
02Load the demo storeSay yes when the installer asks — or run pnpm run seed later. It uploads the 244 demo images to your image provider and loads 55 products, 35 categories, 3 shops, 16 journal posts, the home page, coupons and store settings.
03Start everythingpnpm run dev boots the storefront on :3000, the dashboard on :3001 and the API on :8000 through Turbo.
04Create the first administratorOpen http://localhost:3001 — it redirects to /setup while no admin exists. Complete the form and you are signed in.

terminal

node setup.js
pnpm run dev

Manual equivalent

terminal

pnpm install
# edit .env: MONGO_URI, JWT_SECRET and ImageKit or Cloudinary keys
pnpm run seed
pnpm run dev

What you should see

Surface	URL
Storefront	http://localhost:3000
Dashboard	http://localhost:3001
API + Swagger	http://localhost:8000/api/docs
Offline documentation	`documentation/index.html` in the package

Dashboard sign-in — The dashboard's sign-in page, with the Admin and Seller doors.

Demo coupons the checkout accepts: GROVIA25, FRESH10, PLUS5.

Complete setup right awayUntil you complete /setup, whoever reaches the dashboard first becomes the administrator. The API warns about this on every boot while the window is open. Do it immediately after any fresh deploy.