E-commerce that
feels like Laravel
A headless Laravel e-commerce package built on Eloquent. Familiar conventions for you, and for your AI coding agent.
# install
$ composer require lunarphp/lunar
# give your agent the docs
$ claude mcp add lunar-docs --transport http https://docs.lunarphp.com/mcp
One package, complete commerce
Products, orders, customers and a full admin panel. One Composer command to install, one MCP command to bring your agent up to speed.
E-Commerce Core
Eloquent models, pipelines and event-driven architecture — build any storefront without fighting the framework.
Admin Panel
A production-ready admin panel for managing products, orders and customers out of the box, then extend it to fit your workflow.
Starter Kit
Hit the ground running with an Inertia + Vue storefront. Authentication, cart and checkout — ready to customise from day one.
Your catalogue, fully under control
Products, variants, pricing, media and collections — managed through a clean, extensible admin panel.
Code like it's just Laravel
No new DSL to learn. Lunar is built on Eloquent models, so querying products works like any other model. That matters when an agent is writing the code: it already knows this pattern.
- Standard Eloquent models and relationships
- Extend with custom attributes and fields
- Pipeline-based cart and order processing
- Built-in Laravel Scout search integration
- Docs MCP server and llms.txt for AI-assisted development
$url = Url::whereElementType($type)
->whereSlug($slug)
->with($eagerLoad)
->first();
$product = $url->element;
if ($product->status !== 'published') {
return abort(404);
}
Your coding agent already speaks Lunar
Lunar is Laravel e-commerce built for agentic development. The docs are readable by models, the code is plain Eloquent, and setup is a single command.
Docs MCP server
One command adds it to Claude Code, Cursor or VS Code. Your agent fetches current documentation instead of guessing from training data.
$ claude mcp add lunar-docs --transport http https://docs.lunarphp.com/mcpLaravel Boost skill
Orients the agent in a Lunar project: where the models and facades live, which config matters, and which docs page covers each task.
$ php artisan boost:add-skill lunarphp/lunarllms.txt and llms-full.txt
A structured index and the full documentation in one file. Paste the whole knowledge base into any model, or append .md to any docs URL.
$ curl -s https://docs.lunarphp.com/llms-full.txtPlain Eloquent
No DSL, no magic. Agents have seen millions of lines of Laravel, so they write correct Lunar code on the first pass.
Product::with('variants.prices')->get()Built for real-world commerce
From product catalogue management to order processing, Lunar covers the features you actually need to run a store.
Products & Catalogue
Product Types
Define different product types — clothing, electronics, digital goods — each with their own attribute configuration.
Custom Attributes
Store exactly the data you need with text fields, rich text, dropdowns, toggles and more. No schema migrations required.
Variants
Sell products with multiple options like size, colour or material, each with independent pricing and stock.
Collections
Build hierarchical collection groups to organise products for navigation, promotions or seasonal campaigns.
Image Resizing
Define image conversions once and always have the right sizes available for thumbnails, listings and detail pages.
URLs
Assign multiple URLs to products and collections with automatic redirects and full internationalisation support.
Organisation
Channels & Availability
Publish products to specific channels and schedule exactly when they become available to customers.
Product Classification
Classify products by type, brand and tags for flexible filtering and faceted search.
Associations
Configure cross-sells, up-sells and alternatives to increase average order value.
Identifiers
SKU, GTIN, MPN, UPC/EAN — all built in and ready for marketplace and shopping feed integrations.
Orders & Customers
Orders
Full order lifecycle management — payments, statuses, refunds and customer notifications in one place.
Customers
Link orders to customer accounts, view purchase history and support B2B ordering with multiple users per account.
Customer Groups
Segment customers into groups for exclusive pricing, restricted products or tailored availability.
Commerce Engine
Pricing
Multi-currency support, tax rates and zones, tiered pricing and discount rules — all handled out of the box.
Shipping
Flexible shipping modifiers for custom rules, or use the built-in shipping rates table for simpler setups.
Inventory
Track stock levels, set backorder limits and control exactly when a product is available for purchase.
Frequently Asked
Questions
Common questions from developers and store owners.
Yes. Lunar is MIT-licensed and completely free. We may offer premium add-ons in the future, but the core package will always be open source.
Lunar is a Laravel package, so your storefront can use whatever stack you prefer — Blade, Inertia, a React SPA, or a completely separate frontend.
Lunar lives inside your Laravel app, so you get full code ownership, no monthly fees and zero platform lock-in. You keep all the power of Laravel while gaining a complete e-commerce toolkit.
Lunar is headless — it provides the backend and admin panel, and you build the storefront however you like. Starter kits are available to help you hit the ground running.
Absolutely. Because Lunar is just a Laravel package, you can expose your own API routes and connect any iOS, Android or third-party frontend.
Yes. The docs ship an MCP server you can add to Claude Code, Cursor or VS Code in one command, so your agent reads current documentation instead of guessing. There is also a Laravel Boost skill, llms.txt and llms-full.txt for any model, and every docs page can be fetched as plain Markdown.
Lunar is plain Laravel and Eloquent with no proprietary DSL, so an agent already knows the patterns it needs. The documentation is designed to be read by models as well as people, and the whole package is open source, so the agent can read the code it is building on.
Still have questions? Ask on GitHub Discussions or Discord.
Ready to own your storefront?
Install Lunar into any Laravel app, point your agent at the docs, and start building a store you fully control.