Skip to main content
The Livewire Starter Kit is a basic reference implementation for building a storefront with Lunar using Laravel Livewire. It demonstrates how to load products and collections, manage a cart, and process a checkout.
This starter kit is intended as a reference implementation only and is not production-ready. An Inertia + Vue Starter Kit is currently in development and will serve as a production-ready foundation for new storefront projects.
To install Lunar into an existing Laravel application instead, follow the installation guide.

​
Requirements

  • PHP >= 8.2
  • MySQL 8.0+ / PostgreSQL 9.4+
  • exif PHP extension (on most systems it will be installed by default)
  • intl PHP extension (on most systems it will be installed by default)
  • bcmath PHP extension (on most systems it will be installed by default)
  • GD PHP extension (used for image manipulation)

​
Installation

A suitable local development environment is needed to run Lunar. Laravel Herd is recommended for this purpose.

​
Create a new project

composer create-project --stability dev lunarphp/livewire-starter-kit my-store

cd my-store
Or using the Laravel Installer: 
laravel new my-store --using=lunarphp/livewire-starter-kit

cd my-store

​
Configure the Laravel app

Copy the .env.example file to .env and update the values to match the local environment. 
cp .env.example .env
All relevant configuration files are included in the repository.

​
Migrate and seed

Install Lunar: 
php artisan lunar:install
Seed the demo data: 
php artisan db:seed
Link the storage directory: 
php artisan storage:link

​
Access the storefront

Once installation is complete:
  • Storefront: http://<yoursite>
  • Admin panel: http://<yoursite>/lunar

​
Source code

The full source is available on GitHub: lunarphp/livewire-starter-kit.