susheelbhai/laravel-ecom

E-commerce layer for Laravel, designed to extend susheelbhai/laravel-basekit.

Maintainers

Package info

github.com/susheelbhai/laravel-ecom

Language:TypeScript

pkg:composer/susheelbhai/laravel-ecom

Statistics

Installs: 12

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

v1.2.0 2026-04-20 16:34 UTC

Requires

MIT 54a8cd7ac05a47c19b8160d61a87dc69ac3ed775

  • Susheel Kumar Singh <susheelkrsingh306.woop@gmail.com>

This package is auto-updated.

Last update: 2026-04-20 17:06:41 UTC

README

Full-stack e-commerce layer for Laravel (Inertia + React + Fortify + Spatie Permission/Media + Larapay).

Important: Install this after susheelbhai/laravel-basekit is installed and you have completed the Basekit setup flow.

Requirements

  • PHP ^8.2
  • Laravel 12 or 13
  • susheelbhai/laravel-basekit already installed and configured
  • Node.js 20+ (frontend toolchain)

Installation

Laravel

Require this package in your app and update Composer.

composer require susheelbhai/laravel-ecom

Configuration

Required command order

Run these commands in order.

Installs the required Composer and NPM packages into your app (already-installed packages are skipped).

php artisan ecom:install_package

What it installs:

  • Uses Basekit’s installer helper (Fortify, Inertia, Spatie Permission/Media, Socialite providers, Ziggy, etc.)
  • Adds e-commerce extras: laravel/wayfinder, susheelbhai/larapay, and the @laravel/vite-plugin-wayfinder NPM package

Publishes the e-commerce application files (controllers, models, routes, views, migrations, seeders, assets, etc.) into your app.

php artisan vendor:publish --tag=ecom --force

Registers the e-commerce service providers in bootstrap/providers.php (Inertia SSR guard during Vite HMR, review aggregate observer). Run this after vendor:publish so the provider classes already exist under app/Providers/. With no flags, only bootstrap/providers.php is updated (safe and idempotent; Basekit is not run).

php artisan ecom:initial_settings

If you have not run Basekit’s environment wizard yet and want it in the same session, use:

php artisan ecom:initial_settings --with-basekit

You should still publish e-com assets when needed; provider files under app/Providers/ must exist before the app boots.

Database

Refresh the database and seed:

php artisan migrate:fresh --seed

Adjust seeders to match your environment.

Frontend (Vite, Wayfinder, React)

After publishing, merge/replace your app’s root package.json and vite.config.ts with the versions provided by this package under assets/root/ (or publish with react_ecom_for_non_react_project and reconcile conflicts).

Then install/build and generate Wayfinder routes:

npm install
npm run build
php artisan wayfinder:generate --no-interaction

Use npm run dev during development.

Environment / config

  • Copy/merge required .env keys for payments (config/payment.php), mail, and third-party APIs from your reference project.
  • config/ecom.php is merged by the package provider; publish config if you need to override defaults.

Installation with single action

From a fresh Laravel app (after Basekit is completed), run:

composer require susheelbhai/laravel-ecom

php artisan ecom:install_package
php artisan vendor:publish --tag=ecom --force
php artisan ecom:initial_settings
php artisan migrate:fresh --seed
npm install
npm run build
php artisan wayfinder:generate --no-interaction
npm run dev

License

MIT