LaravelE-commerceStarter

reyhan — Laravel Ecommerce Template

By reyhan-commerce

Reyhan Commerce is a Laravel-based headless e-commerce backend framework distributed via Composer, providing OpenAPI interfaces, a Filament admin panel, and a Redis inventory locking mechanism.

Explore the design

Compare the page layouts and mobile experience. Open any screenshot for a closer look.

2 previews
Desktop homepage1 / 2
Desktop captureTop of page

Actual screenshot captured by the server browser.

All pages & views 2

Screenshots show visual appearance; interactive behavior may differ.

Recorded 2026-10-05View source

What stands out

A quick read of the recorded project description.

01

Headless backend framework: distributed via Composer, provides an OpenAPI 3.1 contract (generated by Scramble at /docs/api), and does not restrict the frontend technology stack

02

Domain facades and pipelines: provides Cart, Pricing, Inventory, Checkout, Ledger, and Reyhan facades, as well as customizable cart calculation and order creation pipelines

03

Double-entry Ledger engine: LedgerService and the Ledger facade enforce transaction integrity according to debit-credit balance constraints

04

Two-level concurrency and inventory locking: Redis sorted sets with self-cleaning TTL, and database pessimistic row locks at checkout

05

Zero core modification extensions: supports dynamic model replacement and PSR-4 dynamic extensions placed in the extensions/ directory

06

Admin panel: based on Filament and Livewire, including RBAC permissions and audit logs

Template Details

Reyhan Commerce is a headless e-commerce backend framework; the repository reyhan-commerce/reyhan is the application skeleton (starter skeleton), while the core engine resides in the separate reyhan-commerce/core package. The README states that it is distributed via Composer, provides a standard OpenAPI 3.1 contract (generated by Scramble at /docs/api), and can be used with any frontend technology; the official ecosystem lists a Nuxt 4 storefront layer.

The backend is based on PHP 8.4+ and Laravel, the admin panel uses Filament and Livewire, the primary database is PostgreSQL, cache, sessions, and queues use Redis, the runtime optionally supports FrankenPHP Octane and Caddy, and testing uses Pest. The README describes domain facades (Cart, Pricing, Inventory, Checkout, Ledger, Reyhan), mountable cart calculation and order creation pipelines, a double-entry Ledger engine, and a two-level concurrency and inventory locking mechanism (Redis sorted sets with TTL, plus database pessimistic row locks at checkout). Extension methods include dynamic model replacement and PSR-4 dynamic extensions placed in the extensions/ directory.

Installation can be done via the official Composer CLI (composer global require reyhan-commerce/installer followed by reyhan new) or composer create-project plus php artisan reyhan:install; after cloning the repository, ./reyhan doctor, ./reyhan install, and ./reyhan dev can be used to complete environment checks, initialization, and development server startup. The README does not provide performance data beyond specific version numbers, deployment topology, or production environment operations details; related claims (such as "production-ready" and "zero-breaking upgrades") are project self-descriptions and no verification basis is given in the materials.

LaravelE-commerceStarter

Is it right for your project?

Use Cases

  • Providing an e-commerce backend API for Nuxt, Next.js, Flutter, or native mobile applications
  • Order and checkout systems that require double-entry accounting and inventory concurrency control
  • Customizing e-commerce domain logic through PSR-4 extensions in the extensions/ directory
  • Building an operations admin panel with RBAC and audit logs using Filament

Suitable For

  • Backend development teams familiar with PHP and Laravel
  • E-commerce projects that need a headless architecture and choose their own frontend technology stack
  • Medium-to-large projects that need dynamic model replacement and modular extension capabilities

Getting started & customization

Use these recorded setup notes alongside the repository instructions for your chosen version.

  1. 1

    Use the official CLI: composer global require reyhan-commerce/installer, then run reyhan new my-store

  2. 2

    Or use composer create-project reyhan-commerce/reyhan my-store, then run php artisan reyhan:install

  3. 3

    After cloning the repository, run ./reyhan doctor to check prerequisites (the README lists PostgreSQL 17+, Redis 7+, PHP 8.4+)

  4. 4

    Run ./reyhan install to initialize the database, encryption keys, and seed data, then use ./reyhan dev to start the development server

  5. 5

    The README does not provide specific steps for production deployment, containerization, or operations configuration

Read repository instructions

License & source material

Usage conditions & limitations

Free to use · keep license notice

This entry covers the free version under the MIT license in the public repository; the free scope is the code of this version and does not mean that external services or third-party materials are free.

Must comply with when using

  • Free use, modification, commercial use, and distribution of this version's code are permitted.
  • When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
  • The code is provided as-is; warranties and limitations of liability are governed by the original license and applicable law.

Additional costs & items to verify

  • Demo images, fonts, icons, and other third-party materials must be checked against their respective licenses and cannot be judged solely by the code's MIT license.
  • External services such as domains, hosting, databases, payments, or AI may incur additional charges.
  • The official Nuxt 4 storefront layer (reyhan-commerce/storefront-nuxt) is marked as Official Commercial and is a separately licensed commercial component, not included in the MIT free code scope.
  • Local development must meet system prerequisites such as PostgreSQL 17+, Redis 7+, and PHP 8.4+.
  • The official installation method relies on globally installing the reyhan-commerce/installer package via Composer.
View Original Text Basis

Permission is hereby granted, free of charge

Original License Text

| [**reyhan-commerce/storefront-nuxt**](https://github.com/reyhan-commerce/storefront-nuxt) | Decoupled Nuxt 4 Storefront Layer | `storefront-nuxt` | Official Commercial |

Original README

# Verify system prerequisites (PostgreSQL 17+, Redis 7+, PHP 8.4+)

Original README

composer global require reyhan-commerce/installer

Original README
https://github.com/reyhan-commerce/reyhan/blob/main/LICENSEhttps://github.com/reyhan-commerce/reyhan/blob/main/README.md

Compiled by DeepSeek based on repository license and README ·2026-10-05. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.

Project checks & description sources

Template Information

Source platforms
GitHub
Documentation and maintenance reference score
More documented · 85 / 100
Technologies
Laravel
Website type
E-commerce · Starter
How this score is calculated

Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.

What to verify for this project

Repository update recorded
2026-10-05
Screenshot last checked
2026-10-05

A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.

The catalog identifies Laravel as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.

Use a selection guide →

How this description was prepared

AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.

Review declaration: codex-user-requested-batch-review-20261017 · 2026-10-16

Inspect the recorded source material

SHA-256: 058fd588bd137f9cdf09fd5bf575e728fb5b93f0ea436aab56a8df5580cd1b52

2026-10-05T14:47:13.870Z

Source file / repository
<div align="center">

<img src="public/images/banner.png" alt="Reyhan Commerce Framework" width="780" style="max-width: 100%; border-radius: 12px; margin-bottom: 24px;" />

#  Reyhan Commerce

### The Sovereign Enterprise Headless E-Commerce Framework
**Engineered for High-Concurrency, Dynamic Extensibility & Zero-Breaking Upgrades**

[![License: MIT](https://img.shields.io/badge/License-MIT-emerald.svg)](LICENSE)
[![Status: Production Ready](https://img.shields.io/badge/Status-Enterprise%20Grade-10b981.svg)](https://reyhan-commerce.github.io/docs/)
[![Architecture: Headless Framework](https://img.shields.io/badge/Architecture-Headless%20Framework-blue.svg)](https://reyhan-commerce.github.io/docs/v1/architecture/lifecycle)
[![Documentation](https://img.shields.io/badge/Docs-Live%20Website-10b981.svg)](https://reyhan-commerce.github.io/docs/)

[**📖 Read Full Documentation**](https://reyhan-commerce.github.io/docs/) • [**🚀 Getting Started**](https://reyhan-commerce.github.io/docs/v1/getting-started/installation) • [**🏛 Architecture**](https://reyhan-commerce.github.io/docs/v1/architecture/lifecycle) • [**🛠 CLI Reference**](https://reyhan-commerce.github.io/docs/v1/cli/cli-reference)

</div>

---

## ⚡ Quick Start

### 1. Official Composer CLI Installer

Scaffold a production-ready Reyhan Commerce backend using our official Composer-native CLI tool:

```bash
composer global require reyhan-commerce/installer
reyhan new my-store
```

### 2. Composer Create-Project

Or install directly via standard Composer:

```bash
composer create-project reyhan-commerce/reyhan my-store
cd my-store
php artisan reyhan:install
```

### 3. Local Development & Orchestrator

Clone this repository and run the central CLI orchestrator:

```bash
# Verify system prerequisites (PostgreSQL 17+, Redis 7+, PHP 8.4+)
./reyhan doctor

# Provision database, encryption keys, and seeders
./reyhan install

# Start backend development server
./reyhan dev
```

---

## 🏛️ Framework Architecture Pillars

1. **Pure Headless Backend Engine:**
   - Distributed via Composer (`reyhan-commerce/core` & `reyhan-commerce/reyhan`).
   - Standard OpenAPI 3.1 contract generation via Scramble at `/docs/api`.
   - Works seamlessly with any frontend technology (Official Nuxt 4 storefront, Next.js, Flutter, React Native, or iOS/Android native apps).
2. **First-Class Domain Facades:**
   - Modern, expressive Laravel facades (`Cart`, `Pricing`, `Inventory`, `Checkout`, `Ledger`, `Reyhan`).
3. **Hookable Commercial Pipelines:**
   - Dynamic, customizable pipes for `CartCalculationPipeline` and `OrderCreationPipeline`.
4. **General Financial Ledger Engine:**
   - Double-entry bookkeeping core (`LedgerService` & `Ledger` facade) enforcing strict debit-credit balance and transaction integrity.
5. **Two-Tier Concurrency & Stock Locking:**
   - Tier 1: Distributed memory Sorted Sets with self-purging TTL to eliminate ghost inventory locks.
   - Tier 2: Database-level pessimistic row locking during checkout payment settlement.
6. **Sovereign Extensibility (Zero Core Modification):**
   - **Dynamic Model Swapping:** Domain workflows resolve entities dynamically through contracts and resolvers.
   - **Dynamic PSR-4 Extensions:** Drop plugins into `extensions/` with automatic classloader namespace injection and `ReyhanExtensionServiceProvider`.

---

## 🛠️ Technology Stack & Architectural Foundation

| Domain | Technology / Engine | Architectural Role & Rationale |
| :--- | :--- | :--- |
| **Backend Engine** | **PHP 8.4+ & Laravel 13** | Implements single-responsibility `final` Action classes, strongly-typed DTOs (`spatie/laravel-data`), native Eloquent models, and robust queue workers. |
| **Admin Backoffice** | **Filament 5 & Livewire 3** | High-productivity reactive admin panel, RBAC permissions (`filament-shield`), real-time websocket updates, and audit logging. |
| **Primary Database** | **PostgreSQL 17+** | Enterprise JSONB variant matrices, GIN indexing, `pg_trgm` fuzzy text search, and ACID pessimistic row-locking (`lockForUpdate`). |
| **Memory & Mutex Engine** | **Redis 7+** | Sub-millisecond cart caching, distributed sessions, Horizon queue workers, and atomic Lua script stock reservations. |
| **High-Performance Runtime** | **FrankenPHP Octane & Caddy** | Worker-mode execution for microsecond response times and automated SSL certificate provisioning. |
| **Testing & Quality Assurance** | **Pest 4** | End-to-end domain feature testing, concurrency assertions, architecture linting, and automated workflow tests. |

---

## 📂 Application Anatomy

```text
reyhan/
├── app/                             # Application Domain Layer & Custom Overrides
│   ├── Actions/                     # Single-responsibility userland action classes
│   ├── Filament/                    # Admin Backoffice resources, pages & dashboards
│   └── Providers/                   # Application service providers
├── bootstrap/                       # Laravel 13 framework bootloader
├── config/                          # Application & Reyhan driver configurations
├── database/                        # Migrations, seeders, and model factories
├── extensions/                      # Isolated custom modular extensions (PSR-4)
├── public/                          # Web server entrypoint & compiled assets
├── routes/                          # Web, API, and console route definitions
├── storage/                         # Application logs, caches, and uploaded assets
├── tests/                           # Pest 4 test suite (Feature, Unit, Architecture)
├── artisan                          # Laravel command-line interface
├── composer.json                    # Application dependencies (reyhan-commerce/core)
├── reyhan                           # Central orchestrator CLI
└── version.json                     # Release & compatibility manifest
```

---

## 🌐 Official Ecosystem Repositories

| Repository | Role | Package Name | Status |
| :--- | :--- | :--- | :--- |
| [**reyhan-commerce/core**](https://github.com/reyhan-commerce/core) | Core Engine Package (Facades, Actions, Pipelines, Models) | `reyhan-commerce/core` | Open Source (MIT) |
| [**reyhan-commerce/reyhan**](https://github.com/reyhan-commerce/reyhan) | Application Skeleton Starter (This Repository) | `reyhan-commerce/reyhan` | Open Source (MIT) |
| [**reyhan-commerce/create-reyhan**](https://github.com/reyhan-commerce/create-reyhan) | Composer-native CLI Scaffolder | `reyhan-commerce/installer` | Open Source (MIT) |
| [**reyhan-commerce/storefront-nuxt**](https://github.com/reyhan-commerce/storefront-nuxt) | Decoupled Nuxt 4 Storefront Layer | `storefront-nuxt` | Official Commercial |
| [**reyhan-commerce/docs**](https://github.com/reyhan-commerce/docs) | Official Documentation Portal | VitePress | Live Online |

---

## 📄 Dedicated Specification Files

- [Framework Architecture (`FRAMEWORK.md`)](./FRAMEWORK.md): Architectural design, concurrency lifecycle, and zero-breaking upgrade guarantees.
- [Backend Technical Specification (`BACKEND.md`)](./BACKEND.md): Detailed backend architecture, PostgreSQL schemas, payment drivers, SMS pipelines, and Pest testing suites.
- [Admin & Plugins Guide (`PLUGINS.md`)](./PLUGINS.md): Admin panel plugins, modular extensions architecture, and evaluation checklists.
- [Execution Roadmap (`ROADMAP.md`)](./ROADMAP.md): Milestone progress and upcoming major features.
- [AI & Coding Agent Standards (`AGENTS.md`)](./AGENTS.md): Strict guidelines and protocol for AI coding assistants.

---

<div align="center">
  <sub>Released under the MIT License. Copyright © 2026 Reyhan Commerce.</sub>
</div>
Report a correction

Explore similar templates

Compare previews and descriptions within the same stack and category.