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
- Open
http://localhost:3000/login(or your domain). - Enter the email/password you set as
SEED_SUPER_ADMIN_EMAIL/SEED_SUPER_ADMIN_PASSWORDwhen seeding. - 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:
- Platform name — shown in the header, emails, and metadata
- Logo & favicon URLs — upload via Media, then paste the URL
- Support email — shown in the footer
- Operating mode — MULTI_VENDOR for a marketplace, SINGLE_VENDOR for your own single store (hides vendor-specific UI)
- Default language — SaleX ships multi-language support; the storefront has a
/[language]localized route
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
- Admin → Payments: enable the providers you want (Stripe, PayPal, SSLCOMMERZ, bKash, Nagad, Razorpay, Cash on Delivery).
- Enter each provider's credentials — either from the provider's dashboard (Stripe keys start with
sk_test_…) or via .env (see Environment). - Keep each gateway in TEST mode until you have verified checkout end-to-end; switch to LIVE before going public.
- 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
- Admin → Shipping → Methods: enable methods (flat rate, weight-based, item-based, free shipping, store pickup, express…).
- Zones: create delivery zones — a country fallback, then more specific regions/cities. More specific zones win automatically.
- Rates: attach rates to methods per zone — amounts, free-shipping thresholds, weight brackets.
- Vendor policies: decide what vendors may configure themselves vs. what you lock globally.
- 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
- Admin → Vendors: approve, reject, or suspend vendor applications.
- Set the commission rate and payout policy in settings.
- Decide auto-approval of new products or manual review (recommended: manual at first).
7. Content & homepage
- Homepage sections (Admin → Storefront): enable, disable, and reorder sections — hero, categories, product collections, deals, auctions, presales, live, classifieds. Empty sections hide automatically.
- Categories & brands: create your real taxonomy; assign products.
- CMS pages: About, FAQ, policies (privacy, terms, returns).
8. Place a test order
- Create (or use) a customer account; add any in-stock product to the cart.
- 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).
- In Admin → Orders, confirm the order, its per-vendor sub-orders, and the shipping charge snapshot.
- 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.