Frequently Asked Questions

General

Do I need to know Laravel or React to use StoreMine?

No. Installation is a fixed list of CLI commands, and everything day-to-day happens in the admin panel. Development skills are only needed if you want to customise the code.

Is there a web installer?

No — installation is intentionally CLI-based. It's faster, scriptable, and leaves no installer code on your server. The full walkthrough takes about 10 minutes.

Can I run it on shared hosting?

Only if the host provides SSH, PHP 8.3+, and a way to keep a queue worker running. A small VPS (1 GB RAM) is the recommended minimum — see Requirements.

AI

Do AI features cost extra?

StoreMine itself adds no AI fees. You bring your own API keys (Anthropic, Gemini, OpenAI, FAL, Replicate) and pay those providers directly for what you use.

Does the store work without any AI keys?

Fully. AI sections simply show a "not configured" state until a key is added, and can be switched off again by removing the key.

Payments

Which payment methods are supported?

Cash on Delivery (zero config), Stripe, PayPal, bKash and SSLCommerz. Enable any combination under Admin → Settings → Payments.

Payments succeed but orders stay "pending" — why?

The gateway's webhook isn't registered. Add the webhook URLs from deploy/DEPLOYMENT.md to each provider's dashboard.

Can I use StoreMine outside Bangladesh?

Yes. bKash, SSLCommerz and the Steadfast courier are optional regional integrations — Stripe, PayPal and COD work worldwide, and shipping zones/rates are fully editable.

Operations

How do I reset an admin password?

php artisan storemine:admin-password [email protected]

Emails aren't sending — what do I check?

  1. Queue worker running? (sudo supervisorctl status)
  2. SMTP settings correct? Use the test-send in Settings → Email Config
  3. php artisan storemine:preflight flags both automatically.

How do I update to a new version?

Upload/pull the new code, then run ./deploy/deploy.sh — it handles dependencies, build, migrations and caches with maintenance mode around the whole thing.

Where are my uploads stored?

storage/app/public on local disk (linked to public/storage), or your S3/Spaces bucket if configured. Back up the database + uploads and you can rebuild everything else.

Customisation

Can I change the design?

Yes — the frontend is React + Tailwind under resources/js. Run npm run dev while editing, npm run build for production.

Can I add my own language?

The storefront ships with a language switcher; locales are managed via Laravel's standard localisation (APP_LOCALE, APP_FALLBACK_LOCALE, lang/ files).