Skip to content

beikeshop/beikeshop-resource

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 

Repository files navigation

BeikeShop - An Open Source, User-Friendly Cross-Border E-commerce Platform

Quick start | Environment | Key Features | Page Previews | Demo

logo logo logo

logo logo logo

English | 简体中文

BeikeShop — Open Source PHP & Laravel Ecommerce Platform

BeikeShop is an open-source ecommerce platform built on PHP and Laravel, designed for developers and businesses to launch self-hosted online stores with lightning-fast deployment and full control over code, data, and infrastructure. It offers a highly intuitive, out-of-the-box solution that enables users to move from installation to a fully functional store with ease and efficiency.

The platform provides a comprehensive ecommerce foundation—including product management, shopping cart, checkout, payments, shipping, multi-language, multi-currency support, and REST APIs—making it the ideal choice for global independent online stores.

Engineered for seamless secondary development, BeikeShop follows a modular, event-driven architecture. By utilizing a robust Hook and Event-based system, developers can extend features, build plugins, and integrate third-party services through non-intrusive customization, ensuring the core code remains untouched for easy maintainability and upgrades.


Tech Stack

  • Language: PHP 8.1+
  • Framework: Laravel 10
  • Frontend: Blade Templates, Vue.js
  • Architecture: MVC, Modular, Event-driven
  • Security & Logic:Middleware, Webhook Engine
  • Frontend: Blade / vue / jQuery / sass / Bootstrap
  • Database: MySQL, PostgreSQL
  • Deployment: Docker

Use Cases

  • PHP / Laravel ecommerce projects
  •  Custom online stores
  • International ecommerce
  • Open‑source ecommerce learning and development

Why BeikeShop?

  • 100% Open-Source: Full ownership of code and data.

  • Laravel-Based: Standardized for performance and security.

  • Low Maintenance: Stable, production-ready, and cost-effective.

  • Developer-Friendly: Modular architecture for fast customization.

  • Lightweight: Agile alternative to bloated ecommerce platforms.


Live Demo


Quick Start

BeikeShop can be installed via package distribution, source code, or Docker.

I. Package Installation

  1. Download BeikeShop: https://beikeshop.com/download

  2. Upload and unzip the package on your server.

  3. Set the public directory as the web root.

  4. Visit the site in your browser and follow the installation wizard.

  5. Installation guide: https://docs.beikeshop.com/en/install/bt.html

  6. For upgrades, overwrite files (keep .env) and run:

    php artisan migrate

II. Source Code Installation

git clone https://github.com/beikeshop/beikeshop.git
cd beikeshop
composer install
cp .env.example .env
npm install
npm run prod

Set the public directory as the web root and complete installation via browser.

For upgrades:

git pull
composer install
php artisan migrate

III. Docker Installation

  1. Install Docker & Docker Compose https://docs.docker.com/engine/install/

  2. Clone Docker environment:

    git clone git@gitee.com:beikeshop/docker.git
  3. Create website directory:

    mkdir www
  4. Configure environment:

    cp env.example .env
    docker compose up -d

Detailed guide: https://docs.beikeshop.com/en/install/docker.html


Documentation

* Official Website: https://www.beikeshop.com

* Documentation: https://docs.beikeshop.com/en/


Environment Requirements

  • Independent Server (shared hosting not supported)

  • OS: Ubuntu 22+ / CentOS 8.5

  • PHP: 8.2

  • Database: MySQL 5.7+

  • Web Server: Nginx 1.10+ / Apache 2.4+

Required PHP Extensions

BCMath, Ctype, cURL, DOM, Fileinfo, JSON, Mbstring, OpenSSL, PCRE, PDO, Tokenizer, XML


Key Features

  • Open Source: 100% open-source with full ownership of source code and data.

  • Easy to Use: Designed for rapid deployment, allowing you to go from installation to a live store in minutes.

  • Laravel Framework: Built on Laravel 10+, adhering to standard MVC architecture and industry best practices.

  • Modern UI: Clean, high-conversion storefront and an intuitive admin dashboard for a seamless user experience.

  • Complete Workflow: Out-of-the-box support for products, cart, checkout, payments, shipping, and customer management.

  • Global Commerce: Native multi-language and multi-currency support, ideal for international online stores.

  • Modular Architecture: Decoupled design allowing functional expansion via plugins without modifying the core.

  • Events & Webhooks: Flexible event-driven customization through Webhooks and Listeners for seamless integration.

  • Secure & Reliable: Robust security with role-based access control (RBAC) and strict data validation.

  • Developer-Friendly & REST APIs: Clean codebase with comprehensive REST APIs for headless commerce and mobile apps.

  • ERP & Integration Ready: Easy connection with global payment gateways, logistics, and mainstream ERP systems.

System Overview


Store Preview

Page Previews

  1. DIY Store Customization
DIY_Edit.mp4
  1. Product Detail Page 页面展示3_商品详情页
  2. Admin Product List 页面展示4_后台商品列表

Contributing

  1. Fork this repository.

  2. Create a new feature branch.

  3. Commit your changes.

  4. Submit a Pull Request.


License

BeikeShop is open‑source software licensed under the License: OSL-3.0


Special Thanks

  • Plugin Developers: Lu Chuan Youth, Lao Liu, Aegis, Telon Uncle, Olives, and others.

  • Contributors: nilsir, what_village_head, tanxiaoyong, Lucky, So, licy, Lao Bei, Teemo, and more.

Thank you to everyone who contributes to making BeikeShop better.


Note Please retain the original copyright notice. Removal requires official authorization.

⭐ If you find BeikeShop useful, please consider giving it a star on GitHub!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors