FAQ & Support
Quick answers first, support instructions last.
Frequently asked questions
Is this PHP? Can I install it on cPanel shared hosting?
No. SaleX is a Node.js application (Next.js). It needs a Node.js host — a VPS or a Node-friendly cloud platform. It cannot run on PHP-only shared hosting. See System Requirements → Choosing hosting.
Do I need to pay for anything besides the item license?
The code itself needs no subscription. Typical running costs: a VPS (~$6–12/month), a database (free with PostgreSQL on the same VPS, or free tiers from Supabase/Neon), your domain (~$10/year), and payment provider fees per transaction. Optional: AI provider key for the AI assistant, transactional email service.
Which payment gateways are included?
Stripe, PayPal, SSLCOMMERZ, bKash, Nagad, Razorpay, and Cash on Delivery. Each needs its own merchant credentials before customers can use it; regional gateways require merchant approval from that provider. See Payments & Shipping.
Are courier integrations (DHL, FedEx, local couriers) built in?
SaleX ships a courier adapter interface plus a complete manual workflow (tracking numbers entered by hand, full shipment status flow). No live courier integration is pre-wired — connecting one requires real provider credentials and developer work. The shipping engine itself (zones, rates, per-vendor quotes, pickup, express cutoffs) is fully functional without any courier API.
How do vendors get paid?
Vendors accrue earnings per sale minus your commission. Payout recording is managed in the dashboards; actual money movement happens through your chosen process (bank transfer, provider payout) outside the app unless you build a gateway integration.
Can I run a single-store shop instead of a marketplace?
Yes — set operating mode to SINGLE_VENDOR in Admin → Settings. Vendor-specific UI hides; everything else works the same.
How do I change the currency?
Admin → Settings → Currency: pick the currency and symbol position. Choose it before entering real product prices — stored prices don't auto-convert. The whole storefront (products, deals, auctions, classifieds, checkout, AI assistant) follows this setting.
Where are product images stored?
On the server disk in storage/ (with external-URL support per product). Include this folder in backups. See Database & Storage.
The AI assistant says it's unconfigured — is something broken?
No. The AI features need a provider API key (Admin → Settings → Integrations, or AI_* variables in .env). Without it the rest of the platform works normally. See Environment → Providers.
I forgot the admin password
Use “Forgot password” on /login (requires working email), or set SEED_SUPER_ADMIN_EMAIL/SEED_SUPER_ADMIN_PASSWORD in .env and re-run npm run db:seed on a development database.
Can I translate the storefront?
Yes — SaleX includes multi-language support with localized routes and translation data. See the multilingual documentation in the docs/ folder of the package.
Is my purchase license per-domain?
Codecanyon regular licenses typically cover one end product per license. Check your license terms on Codecanyon or contact the author for extended/occupancy questions — the software itself doesn't enforce domains.
Getting support
- Search this documentation (top search box) and Troubleshooting — most setup issues are covered.
- Codecanyon comments tab for general questions — answers help other buyers too.
- Author support channel (the CodeCanyon support tab / author profile) for account-specific problems.
Include in any request: OS, Node version, local or server, the exact copied error text, and which documentation step you were on. Never include passwords, keys, or .env contents — support can't use them anyway and sharing them compromises your store.