# lunarphp/lunar

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/lunarphp-lunar).**

3,415 stars · 464 forks · PHP · mit

## Links

- GitHub: https://github.com/lunarphp/lunar
- Homepage: https://lunarphp.com
- awesome-repositories: https://awesome-repositories.com/repository/lunarphp-lunar.md

## Topics

`e-commerce` `ecommerce` `filamentphp` `headless` `laravel` `php`

## Description

Lunar is a modular PHP e-commerce framework and headless commerce engine designed to manage the backend logic and data models of an online store. It provides a decoupled infrastructure that separates business logic from the presentation layer, allowing for the orchestration of digital storefronts via an API.

The system is distinguished by its headless-first approach and a dedicated toolkit for building customized administration interfaces using pre-made components and widgets. It supports complex global operations through a multilingual commerce system that handles regional storefront configurations, multiple currencies, and geographic shipping rules.

The framework covers a comprehensive suite of commerce capabilities, including hierarchical product cataloging with custom attribute mapping, shopping cart and checkout coordination, and event-driven order lifecycle tracking. It also incorporates identity and access management through role-based permissions and multi-factor authentication for staff, alongside logistics tools for shipping rate calculation and inventory fulfillment.

The project includes a utility to export structured technical documentation to assist large language models in understanding the project context.

## Tags

### Part of an Awesome List

- [Product Catalog Management](https://awesome-repositories.com/f/awesome-lists/data/product-catalog-management.md) — Provides a comprehensive catalog system for handling product details, pricing, images, and variants. ([source](https://docs.lunarphp.com/1.x/admin/introduction))
- [System Capability Extensions](https://awesome-repositories.com/f/awesome-lists/devtools/core-and-community-extensions/system-capability-extensions.md) — Integrates third-party add-ons through defined extension points to add new operational capabilities to the core system. ([source](https://docs.lunarphp.com/logs/flight-plan))

### Business & Productivity Software

- [E-Commerce Backends](https://awesome-repositories.com/f/business-productivity-software/e-commerce-platforms/e-commerce-backends.md) — Implements the core server-side logic and administrative panel for managing retail operations and e-commerce data. ([source](https://docs.lunarphp.com/1.x/getting-started/overview/local-development))
- [Commerce Engines](https://awesome-repositories.com/f/business-productivity-software/commerce-engines.md) — Serves as a decoupled commerce core that manages business logic and data via an API.
- [Commerce Event Orchestration](https://awesome-repositories.com/f/business-productivity-software/commerce-workflow-extensions/commerce-event-orchestration.md) — Coordinates the sequence of events across catalogs, carts, and checkout to ensure successful purchases. ([source](https://docs.lunarphp.com/))
- [Custom Product Attributes](https://awesome-repositories.com/f/business-productivity-software/custom-product-attributes.md) — Supports diverse product types through flexible attribute mapping that avoids database schema modifications.
- [Customer Account Management](https://awesome-repositories.com/f/business-productivity-software/customer-account-management.md) — Handles user authentication, personal account sections, and the tracking of customer order histories. ([source](https://docs.lunarphp.com/1.x/getting-started/starter-kits/inertia-vue))
- [E-commerce Integrations](https://awesome-repositories.com/f/business-productivity-software/e-commerce-integrations.md) — Integrates payment processing, shipping cost calculations, and tax application during the checkout process. ([source](https://docs.lunarphp.com/1.x/getting-started/starter-kits/inertia-vue))
- [Regional Storefront Configurations](https://awesome-repositories.com/f/business-productivity-software/multi-store-management/regional-storefront-configurations.md) — Allows for the configuration of multiple languages, currencies, and shipping zones based on customer location.
- [Order Fulfillment](https://awesome-repositories.com/f/business-productivity-software/order-fulfillment.md) — Tracks stock levels and manages the shipping and returns process for customer orders. ([source](https://docs.lunarphp.com/logs/flight-plan))
- [Order Lifecycle Management](https://awesome-repositories.com/f/business-productivity-software/order-lifecycle-management.md) — Coordinates the end-to-end flow of orders from initial placement through payment to final fulfillment.
- [Order Management Systems](https://awesome-repositories.com/f/business-productivity-software/order-management-systems.md) — Provides a comprehensive system for tracking, managing, and fulfilling customer purchases and sales orders. ([source](https://docs.lunarphp.com/1.x/getting-started/overview/local-development))
- [Product Catalogs](https://awesome-repositories.com/f/business-productivity-software/product-catalogs.md) — Provides a system for organizing products into nested groups and hierarchical category structures. ([source](https://docs.lunarphp.com/1.x/guides/catalog-menu))
- [Product Catalog Management](https://awesome-repositories.com/f/business-productivity-software/product-configurators/product-catalog-management.md) — Allows the definition of custom attributes to extend product data models beyond standard fields. ([source](https://docs.lunarphp.com/logs/flight-plan))
- [Checkout Workflows](https://awesome-repositories.com/f/business-productivity-software/purchase-order-management/purchase-order-duplications/checkout-workflows.md) — Implements multi-step checkout processes for address collection, shipping selection, and order creation. ([source](https://docs.lunarphp.com/llms.txt))
- [Regional Commerce Configurations](https://awesome-repositories.com/f/business-productivity-software/regional-commerce-configurations.md) — Localizes storefronts by managing currency, language, and regional shipping and tax rules based on user session.
- [Regional Commerce Management](https://awesome-repositories.com/f/business-productivity-software/regional-commerce-management.md) — Provides tools for configuring multi-regional settings including currency, localization, and international shipping.
- [Shipping Configurations](https://awesome-repositories.com/f/business-productivity-software/shipping-configurations.md) — Determines delivery costs based on geographic zones, cart totals, item weights, and delivery methods. ([source](https://docs.lunarphp.com/1.x/addons/table-rate-shipping))
- [Shopping Carts](https://awesome-repositories.com/f/business-productivity-software/shopping-carts.md) — Provides logic for managing items, sessions, and state within a digital shopping cart. ([source](https://docs.lunarphp.com/llms.txt))
- [Store Administration Panels](https://awesome-repositories.com/f/business-productivity-software/store-administration-panels.md) — Provides a secure management panel for staff to control product inventory, order fulfillment, and regional settings.
- [Store Business Settings](https://awesome-repositories.com/f/business-productivity-software/store-business-settings.md) — A system for setting global parameters for sales channels, supported languages, and currencies to define shop behavior. ([source](https://docs.lunarphp.com/1.x/admin/introduction))
- [Currency Configuration](https://awesome-repositories.com/f/business-productivity-software/currency-configuration.md) — Defines monetary units and exchange rates to synchronize prices and manage decimal precision. ([source](https://docs.lunarphp.com/1.x/getting-started/setup/system-settings))
- [Payment Gateway Integrations](https://awesome-repositories.com/f/business-productivity-software/payment-gateway-integrations.md) — Integrates with payment gateways to handle payment intents, webhooks, and the complete transaction lifecycle. ([source](https://docs.lunarphp.com/1.x/getting-started/overview/local-development))
- [Catalog Renderings](https://awesome-repositories.com/f/business-productivity-software/product-catalogs/catalog-renderings.md) — Provides a system for rendering product listing and display pages with variant selection and faceted filtering. ([source](https://docs.lunarphp.com/llms.txt))
- [Product Relationship Mappings](https://awesome-repositories.com/f/business-productivity-software/product-relationship-mappings.md) — Provides a utility to define cross-sell and up-sell relationships to suggest complementary items on the storefront. ([source](https://docs.lunarphp.com/llms.txt))
- [Sales Channel Management](https://awesome-repositories.com/f/business-productivity-software/sales-channel-management.md) — Provides a system to define distinct sales outlets and control product and discount visibility across multiple storefronts. ([source](https://docs.lunarphp.com/1.x/getting-started/setup/system-settings))
- [Shipping Zone Management](https://awesome-repositories.com/f/business-productivity-software/shipping-zone-management.md) — Limits shipping availability to specific countries, states, or postcodes to control delivery areas. ([source](https://docs.lunarphp.com/1.x/addons/table-rate-shipping))
- [Product Exclusions](https://awesome-repositories.com/f/business-productivity-software/shipping-zone-management/product-exclusions.md) — Prevents specific items from being shipped to designated geographic zones through exclusion lists. ([source](https://docs.lunarphp.com/1.x/addons/table-rate-shipping))

### Web Development

- [PHP E-commerce Frameworks](https://awesome-repositories.com/f/web-development/php-e-commerce-frameworks.md) — Provides a modular developer-centric framework built with PHP for creating and customizing online stores.
- [Headless Commerce](https://awesome-repositories.com/f/web-development/headless-commerce.md) — Decouples backend business logic from the frontend via an API-first headless commerce architecture.
- [Admin Panel Frameworks](https://awesome-repositories.com/f/web-development/admin-panel-frameworks.md) — Provides a specialized framework for building production-ready administrative interfaces using pre-made components. ([source](https://docs.lunarphp.com/logs/flight-plan))
- [Multi-Storefront Orchestrators](https://awesome-repositories.com/f/web-development/e-commerce-storefront-builders/multi-storefront-orchestrators.md) — Coordinates the operation of multiple distinct storefronts from a single centralized backend instance.
- [Field-Level Translation Storage](https://awesome-repositories.com/f/web-development/internationalization-localization/translation-management-platforms/site-localization/multi-language-content-delivery/locale-based-filters/content-translation/field-level-translation-storage.md) — Stores model fields as translations and resolves content based on the active application locale or fallback language.

### Content Management & Publishing

- [Product Collection Hierarchies](https://awesome-repositories.com/f/content-management-publishing/category-organizations/hierarchical-navigations/product-collection-hierarchies.md) — Supports grouping products into categorized collections to simplify store navigation and merchandising. ([source](https://docs.lunarphp.com/1.x/admin/introduction))
- [Multilingual Content Mappings](https://awesome-repositories.com/f/content-management-publishing/multilingual-content-mappings.md) — Links primary language content to translated equivalents for multilingual storefront delivery. ([source](https://docs.lunarphp.com/1.x/getting-started/setup/system-settings))

### Data & Databases

- [Product Discovery Systems](https://awesome-repositories.com/f/data-databases/product-discovery-systems.md) — Provides search functionality and hierarchical navigation to help users locate specific products. ([source](https://docs.lunarphp.com/llms.txt))
- [Product Search Engines](https://awesome-repositories.com/f/data-databases/search-indexing-technologies/search-indexing/search-and-indexing/product-search-engines.md) — Implements an indexing and retrieval system for products and store data using external search engines. ([source](https://docs.lunarphp.com/1.x/getting-started/overview/local-development))

### Security & Cryptography

- [Granular Permission Systems](https://awesome-repositories.com/f/security-cryptography/granular-permission-systems.md) — Controls administrative access through a system of roles and hierarchical permissions. ([source](https://docs.lunarphp.com/1.x/getting-started/overview/security))
- [Access Control](https://awesome-repositories.com/f/security-cryptography/security/policies/access-control.md) — Provides a centralized system for managing backend access using roles, permissions, and MFA for staff. ([source](https://docs.lunarphp.com/llms.txt))
- [Multi-Factor Authentication](https://awesome-repositories.com/f/security-cryptography/multi-factor-authentication.md) — Requires staff members to use two-factor authentication and recovery codes for secure administrative access. ([source](https://docs.lunarphp.com/1.x/getting-started/overview/security))
- [Payment Gateway Security](https://awesome-repositories.com/f/security-cryptography/payment-gateway-security.md) — Delegates card data to compliant providers and verifies webhook signatures to ensure secure payment processing. ([source](https://docs.lunarphp.com/1.x/getting-started/overview/security))
- [Role-Based Access Control](https://awesome-repositories.com/f/security-cryptography/role-based-access-control.md) — Restricts administrative actions by assigning hierarchical permissions to user roles within a staff authentication guard.
- [Session Isolations](https://awesome-repositories.com/f/security-cryptography/user-account-management/session-isolations.md) — Separates staff authentication from customer sessions using a dedicated security guard. ([source](https://docs.lunarphp.com/1.x/getting-started/overview/security))

### Software Engineering & Architecture

- [Modular Extension Architectures](https://awesome-repositories.com/f/software-engineering-architecture/modular-extension-architectures.md) — Provides defined hooks and interfaces allowing third-party add-ons to modify core system behavior.
- [Admin Interface Extensions](https://awesome-repositories.com/f/software-engineering-architecture/component-functional-extensions/admin-interface-extensions.md) — Allows customization of the administration panel through new resource pages and custom attribute fields. ([source](https://docs.lunarphp.com/llms.txt))

### User Interface & Experience

- [Admin Interface Components](https://awesome-repositories.com/f/user-interface-experience/admin-interface-components.md) — Offers a system for assembling administrative dashboards using pre-defined widgets and resource pages.