Documentation

First-Time Setup Checklist

SaleX installed and running? Work through this checklist to turn it from a demo into your marketplace. Do the steps in order.

On this page

1. Sign in as administrator

  1. Open http://localhost:3000/login (or your domain).
  2. Enter the email/password you set as SEED_SUPER_ADMIN_EMAIL/SEED_SUPER_ADMIN_PASSWORD when seeding.
  3. Visit /admin — the admin dashboard loads with stats and the admin navigation.

✓ Success: you see the admin dashboard and can open Admin → Settings.

Change the seeded admin password immediately if it came from a plaintext dev variable — Account settings → Security.

2. Store identity & locale

Admin → Settings — set:

3. Currency

Admin → Settings → Currency: choose the default currency (e.g. USD, BDT, EUR) and symbol position (left/right). The whole storefront — product cards, deals, auctions, classifieds, checkout, the AI assistant — displays prices in this currency.

Prices are stored as integer minor units (cents/poisha) in the platform currency. Existing product prices do not auto-convert when you change the display currency — pick your currency before adding real products.

4. Payments

  1. Admin → Payments: enable the providers you want (Stripe, PayPal, SSLCOMMERZ, bKash, Nagad, Razorpay, Cash on Delivery).
  2. Enter each provider's credentials — either from the provider's dashboard (Stripe keys start with sk_test_…) or via .env (see Environment).
  3. Keep each gateway in TEST mode until you have verified checkout end-to-end; switch to LIVE before going public.
  4. For Stripe, add a webhook endpoint pointing at your domain's Stripe webhook route and paste the signing secret.

✓ Success: a test purchase with a test card completes and appears in Admin → Orders.

5. Shipping

  1. Admin → Shipping → Methods: enable methods (flat rate, weight-based, item-based, free shipping, store pickup, express…).
  2. Zones: create delivery zones — a country fallback, then more specific regions/cities. More specific zones win automatically.
  3. Rates: attach rates to methods per zone — amounts, free-shipping thresholds, weight brackets.
  4. Vendor policies: decide what vendors may configure themselves vs. what you lock globally.
  5. Use the built-in test calculator to preview a destination + cart before customers do.

✓ Success: the checkout shows per-vendor shipping options with correct amounts.

6. Vendor policy

7. Content & homepage

8. Place a test order

  1. Create (or use) a customer account; add any in-stock product to the cart.
  2. Checkout: fill an address matching one of your shipping zones; choose a shipping method; pay with the provider's test method (or Cash on Delivery).
  3. In Admin → Orders, confirm the order, its per-vendor sub-orders, and the shipping charge snapshot.
  4. Advance the shipment status (Admin/Vendor → Shipments) and verify the customer sees the tracking update.

✓ Success: end-to-end — browse → cart → checkout → pay → order visible in both accounts. You are ready for real data.