Skip to content

The clean stack forArtisans and commerce.

Reyhan is batteries-included so everyone can build and ship modern online stores at ridiculous speed.

Reyhan Commerce Framework
Reyhan Framework v1.0.0 is released—Explore the Architecture →

Sovereign Extensibility.

Never modify vendor files again. Customize every layer of your commerce stack with dynamic model registries, hookable pipelines, and drop-in modular plugins.

🔌
Dynamic Model Registry
Swap or augment any core Eloquent model (Product, Order, User, Cart) at runtime via config/reyhan.php. All core actions resolve your subclass automatically.
🔀
Hookable Pipelines
Inject custom stages into critical business workflows (such as B2B credit limits, fraud verification, or VIP discount calculations) using Laravel's Pipeline pattern.
🧩
Modular Extensions (PSR-4)
Drop self-contained extensions inside extensions/. Reyhan dynamically registers PSR-4 autoloading and discovers Service Providers without editing your root composer.json.

High Concurrency & Financial Precision.

Engineered for flash sales and strict financial accounting. Eliminate inventory overselling and balance every single Rial.

🔒
Two-Tier Concurrency Locks
High-speed Redis 7 Sorted Set reservations (with self-purging TTL) combined with PostgreSQL lockForUpdate() pessimistic row locks prevent flash-sale overselling.
⚖️
Double-Entry General Ledger
Every order settlement, wallet transaction, and refund creates strictly balanced journal entries (sum(debits) === sum(credits)) with zero silent balance drift.
⚡️
Octane & FrankenPHP Runtime
Worker-mode execution keeps your application in-memory for microsecond response times and ultra-high throughput under extreme traffic spikes.

Tailored for Iranian E-Commerce.

First-class support for Iranian payment switches, fast-service SMS patterns, postal logistics tariffs, and automatic text normalization.

💳
Multi-Driver Bank Gateways
Unified driver manager supporting Zarinpal, Saman (SEP), Mellat (Behpardakht), Sadad, and offline card-to-card approval workflows.
📲
Pattern-Based Fast OTP SMS
Instant OTP delivery bypassing telecom blacklists via verified service pattern webhooks (Kavenegar, FarazSMS, Ghasedak, MeliPayamak).
🚚
Provincial Logistics & Tariffs
Accurate dimensional weight calculation, neighboring province logic, and carrier drivers for Iran Post (Pishtaz), Tipax, and Chapar.

The Reyhan Ecosystem.

A decoupled suite of official packages and starter kits to launch enterprise commerce in record time.

Core Engine
reyhan-commerce/core
The immutable domain engine package containing actions, typed DTOs, and commercial calculation pipelines.
Starter App
reyhan-commerce/reyhan
The sovereign application skeleton with Filament v5 admin backoffice, configurations, and Pest 4 test suites.
Global CLI
reyhan-commerce/installer
Interactive terminal scaffolder powering reyhan new my-store with database selection and catalog seeding.
Reactive Storefront
storefront-nuxt
Decoupled reactive presentation layer built with Nuxt 4, Tailwind CSS v4, Pinia, and Nuxt UI components.

Ready to Build Sovereign Commerce?

Read the official documentation, explore the architecture, and start building with Reyhan Commerce today.

Released under the MIT License.