Note
xShop is an open-source shop developed in Laravel, highly customizable!
- Dashboard panel improvements
- Integration of Vue.js and Laravel
- Advanced charts
- Better customization with AI & language support
- Fixed technical issues
- Project size compression
- More specific UI/UX
- Developer-friendly
- Custom theme design
Important
Create a new database and rename .env.example to .env, then update your .env configurations. Run the following commands:
git clone https://github.com/4xmen/xshop.git
cd xshop
cp .env.example .env
composer install
php artisan migrate:fresh --seed
php artisan storage:link
php artisan key:generate
php artisan serve
# To develop front-end
npm i
php artisan client
npm install @rollup/rollup-win32-x64-msvc # Windows only, if the below line does not work
npm run dev
# Or with yarn
yarn install
php artisan client
yarn add @rollup/rollup-win32-x64-msvc # Windows only, if the below line does not work
yarn devTip
Default admin emails are: [email protected] (developer) or [email protected] (admin)
Default password: password
- Download and prepare images:
php artisan seeding:prepare- Then copy your image folder to
database/seeders/images/ - Seed images for models: [Group, Category, Post, Product, Slider]
php artisan seeding:image Product digitalOr to seed all models:
php artisan seeding:all digitalThe first parameter is the model name; the second is the image seeder directory. Available directories:
[bag, clothe, digital, sport, posts, makeup]
You can create your own directory, add images to it, and use it with the image seeder.
- PHP 8.2.x or above with extensions:
php-gd,sqlite3,php-soap - MySQL, MariaDB, or SQLite
- Composer
- Recommended: Install ImageMagick on the server for better image performance
We recommend deploying xShop on a VPS. Create a database and run the following commands:
cd /home/[yourUsername]/[pathToYourWebsitePublicHTML]
git clone https://github.com/4xmen/xshop.git . # If this command doesn’t work, empty this folder first
cp .env.example .env
nano .env # Edit your DB config, URL, etc.
composer install
php artisan migrate:fresh --seed
php artisan storage:link
php artisan key:generate
npm install
php artisan client
npm run buildnano .env # Set APP_DEBUG=false, APP_ENV=production
php artisan optimize
composer install --optimize-autoloader --no-devAdd a crontab entry for your project:
crontab -eAdd this line:
* * * * * cd /home/[yourusername]/[your-public-html-project-root] && php artisan schedule:run >> /dev/null 2>&1Create a controller with logging and semi-automatic CRUD with logs.
Usage: [model]
php artisan make:xcontroller UserCreate a reusable theme part in a specific area.
Parameters:
PartName [theme part name]
segmentName [group, category, preloader, ...]
php artisan make:part PartName segmentNameOptimize client assets: scss, js, css
php artisan client
php artisan buildPartName.php: ContainsonCreate,onRemove,onMountactions for the theme partPartName.blade.php: Blade template for the theme partPartName.scss: SCSS styles for the theme partPartName.js: JavaScript for the theme partscreenshot.png: Screenshot preview of the theme part
Online demo available here: https://xshop.xstack.ir/
Warning
xShop/v1 is available here: https://github.com/4xmen/xshop.v1
Developed with ❤️!