 |
| Complete Laravel eCommerce System |
Complete Laravel eCommerce System — Feature-Rich Online Store
A self-hosted Laravel online store with catalog, cart, checkout, payments, admin panel, RBAC, reporting, and tools aimed at Bangladesh addresses and local gateways — plus international options (Stripe, PayPal, etc.).
What this project is — plain English
Self-hosted Laravel store vs hosted SaaS
- You control code, data, and hosting
- Deep customization (gateways, BD address fields, themes)
- No per-order SaaS fee from the platform itself
- Good learning path if you already use Laravel
- You handle updates, backups, SSL, and server security
- You must configure payment keys and test modes carefully
- Scaling traffic = your infrastructure plan (not automatic like big SaaS)
Why eCommerce matters (short)
- Reach — sell beyond a single physical location.
- Always on — customers can order when your shop is “closed.”
- Lower overhead — no full retail footprint for every sale.
- Data — sales and product performance visible in dashboards.
- Scale — add catalog and traffic without opening new stores everywhere.
Install & web installer
Commands (starting point)
git clone https://github.com/needyamin/eCommerceLaravel
cd eCommerceLaravel
composer install
npm install
npm run buildIf the project documents use npm run dev for local assets only, follow the repo README.md. Production builds usually use npm run build.
php artisan serveOpen http://localhost:8000/installer and complete the wizard.
What the installer usually does
- Checks PHP version, extensions, folder permissions
- Tests database connection
- Runs migrations (creates tables)
- Seeds sample data (optional paths depending on version)
- Lets you create the super admin
- Disables itself after success (so strangers cannot re-run setup)
Email:
needyamin@gmail.comPassword:
needyamin@gmail.comRole: Super Admin. Treat this as temporary — set a unique password and email before going live.
If you install without the browser wizard
Many Laravel apps support: copy .env.example to .env, set APP_KEY (php artisan key:generate), configure DB_*, then php artisan migrate --seed. Prefer the project’s README for exact flags.
Storefront & admin — feature overview
Storefront
- Catalog — categories, subcategories, live search
- Cart — guest and logged-in cart; wishlist
- Checkout — Bangladesh-style address (division, district, upazila)
- Payments — bKash, Nagad, Rocket, SSL Commerz, Stripe, PayPal, COD (configure per environment)
- Promotions — coupons; coins/loyalty; referrals
- Reviews & newsletter
- Responsive UI — Tailwind-oriented layouts (see repo for version)
Admin panel
- Dashboard — KPIs, charts, date filters
- RBAC — roles and many granular permissions (124+)
- Products — multiple images, drag order, Quill descriptions, stock, sale pricing, filters (category, stock, sale, price range, etc.)
- DataTables — server-side lists, CSV export, badges for stock
- Orders, users, coupons, categories
- Multi-currency — e.g. BDT, USD, EUR, GBP
- Gateways & shipping/tax — configurable; SMS/OTP options
- Storage — local or S3-compatible (R2, Spaces, Wasabi, B2, etc.)
- Site settings — SEO, schema, sitemap, pages
- Backup/import — export/import; WordPress / Shopify product imports
Payment gateways (examples)
Always use sandbox/test keys until you go live; switch credentials in admin and test a small real payment last.
| Gateway | Type | Notes |
|---|---|---|
| bKash | Mobile banking | Tokenized checkout API (per project docs) |
| Nagad | Mobile banking | Sandbox for testing |
| Rocket | Mobile banking | Sandbox for testing |
| SSL Commerz | Cards / local | Test store before production |
| Stripe | Cards | Test keys |
| PayPal | Online | Sandbox |
| COD | Cash on delivery | No API keys |
Dashboard & analytics
- Cards: revenue, orders, products, customers (exact metrics depend on version)
- Date range filters
- Sales charts; order status breakdown
- Recent orders, top products, low-stock alerts
- Period-over-period style comparisons where implemented
Security & license
- Installer lock — disabled after successful setup
- CSRF, password hashing, sessions — Laravel defaults
- RBAC — limit who can change orders, settings, or users
- License module (per project): key validation, domain lock, periodic checks — read vendor docs before production
APP_DEBUG=false, secure APP_KEY, restricted file permissions, regular backups, and payment keys only in env — never in public repos.What gets created after installation (typical seed)
Numbers match the project description; confirm in your DB after install.
- 1 Super Admin + sample customer user
- 6 categories (with subcategories)
- 72 sample products, 216 images (3 per product)
- 4 currencies; sample coupons (e.g. WELCOME10, SAVE20, …)
- Bangladesh location data (divisions, districts, many upazilas)
- 124+ permission rows; default CMS-style pages
Database & themes
Tables (30+): users, admins, products, images, orders, cart, coupons, reviews, addresses, currencies, settings, roles/permissions, locations, etc.
Themes: at least two storefront themes with an admin switcher; views organized per theme.
Backup & import
- Export products to JSON/CSV; import backups
- WordPress (WXR/XML) and Shopify CSV product imports
- Modes: create new, update, or skip duplicates (per feature)
Requirements & technologies
| Area | Typical requirement |
|---|---|
| PHP | 8.2+ |
| Framework | Laravel (repo states Laravel 12 — verify in composer.json) |
| DB | MySQL / PostgreSQL / SQLite |
| Node | 18+ for front-end build |
| Composer | Required |
Frontend/libs (common in project): Bootstrap, Tailwind (version per repo), DataTables, Chart.js, SweetAlert2, Select2, Quill; Spatie Laravel Permission for RBAC.
Recent updates (as listed in project — 2025)
- Advanced product filters + Select2 product search
- DataTables improvements (images, columns, buttons)
- Dashboard stats/charts and date filtering
- Category and price/stock display tweaks
Benefits by business type (short)
Small businesses: lower startup cost than many physical shops; sell beyond your local area.
Established businesses: add an online channel next to brick-and-mortar; test products in new regions.
Entrepreneurs: faster launch than building every piece from scratch — focus on products and marketing.
Who it’s for
- Small–medium shops; Bangladesh-focused checkout and gateways
- Developers wanting a full Laravel codebase to customize
- Stores needing multi-currency and multiple payment options
- Teams that need RBAC and import/export
Why pick a bundled system like this? One codebase for catalog, checkout, admin, and reports — fewer glue plugins than piecing a CMS + random plugins together, at the cost of you maintaining hosting and updates.
If something goes wrong
| Symptom | What to try |
|---|---|
| Installer won’t open | URL rewrite / php artisan serve port; clear route cache; check APP_URL |
| Database error | Verify DB_* in .env; user grants; MySQL running |
| 500 after deploy | APP_DEBUG=true temporarily on staging; storage and bootstrap/cache writable; php artisan config:clear |
| Assets missing | Run npm run build; publish public build output per README |
| Payment test fails | Sandbox keys, callback URLs, HTTPS in production |
Support & resources
- Email: needyamin@gmail.com
- GitHub: issues on
needyamin/eCommerceLaravel - Docs: README in the repository (source of truth for commands)
Future of eCommerce (brief)
Trends include mobile-first shopping, social selling, AI-assisted recommendations, and better logistics — your stack can evolve, but security, speed, and trustworthy checkout stay the baseline.
Conclusion
This project is a full-featured Laravel eCommerce starter: storefront, admin, payments, and operations tooling in one place. Success depends on solid hosting, safe credentials, tested payment modes, and regular backups — not only on installing the code once.
Comments from Facebook