README

Features

Installation

composer require meubleo/shop
php artisan meubleo:install

That's it. meubleo:install will:

1. Publish config, migrations, stubs and assets
2. Run php artisan migrate
3. Run php artisan storage:link

Then create an admin user:

php artisan meubleo:admin
# or with arguments:
php artisan meubleo:admin "John Doe" john@example.com secret123

Configuration

After install, edit config/meubleo.php:

return [
    'prefix'   => 'admin',          // Admin URL prefix
    'provider' => \App\Meubleo\MeubleoServiceProvider::class,
    'shop_name' => 'My Shop',
    'tax_rate'  => 0.20,
    'free_shipping_threshold' => 500,
    'shipping_cost'           => 29.90,
    'stripe' => [
        'key'    => env('STRIPE_KEY'),
        'secret' => env('STRIPE_SECRET'),
    ],
];

Screen pattern

Create a screen:

php artisan meubleo:screen ProductListScreen

// app/Meubleo/Screens/ProductListScreen.php
class ProductListScreen extends Screen
{
    public function query(): iterable
    {
        return ['products' => Product::paginate(20)];
    }

    public function commandBar(): iterable
    {
        return [
            Link::make('New')->icon('bs.plus')->route('meubleo.admin.products.create'),
        ];
    }

    public function layout(): iterable
    {
        return [ProductTableLayout::class];
    }
}

Table layout

php artisan meubleo:table ProductTableLayout

class ProductTableLayout extends Table
{
    protected string $target = 'products';

    protected function columns(): iterable
    {
        return [
            TD::make('name', 'Product')->sort(),
            TD::make('price', 'Price')
                ->alignRight()
                ->render(fn($p) => meubleo_price($p->price)),
            TD::make('stock', 'Stock')
                ->render(fn($p) => '<span class="badge bg-success">'.$p->stock.'</span>'),
        ];
    }
}

Rows layout (forms)

php artisan meubleo:rows ProductFormLayout

class ProductFormLayout extends Rows
{
    protected function fields(): iterable
    {
        return [
            Input::make('product.name')->title('Name')->required(),
            Select::make('product.category_id')
                ->fromModel(Category::class, 'name')
                ->title('Category'),
            Input::make('product.price')->title('Price')->type('number'),
            Switcher::make('product.is_featured')->title('Featured'),
        ];
    }
}

Artisan commands

Package structure

src/
├── Platform/
│   ├── Shop.php                      ← Central singleton registry
│   ├── MeubleoServiceProvider.php    ← Abstract provider to extend
│   ├── Providers/
│   │   ├── FoundationServiceProvider ← Auto-discovered entry point
│   │   ├── ConsoleServiceProvider    ← Artisan commands + publish tags
│   │   ├── RouteServiceProvider      ← Loads routes
│   │   └── PlatformServiceProvider   ← Loads user's provider
│   ├── Commands/                     ← meubleo:install, screen, table…
│   ├── Http/
│   │   ├── Controllers/              ← Shop + Cart + Checkout + Orders
│   │   ├── Screens/                  ← DashboardScreen, ProductListScreen…
│   │   ├── Layouts/                  ← ProductTableLayout, ProductFormLayout
│   │   └── Middleware/AdminMiddleware
│   ├── Models/                       ← Product, Category, Order… (meubleo_* tables)
│   └── Services/                     ← CartService, OrderService
├── Screen/
│   ├── Screen.php                    ← Abstract base screen
│   ├── Field.php                     ← Abstract field with fluent API
│   ├── Layout.php, TD.php, Action.php
│   ├── Fields/    Input, Select, TextArea, Switcher, Password, DateTimer…
│   ├── Layouts/   Table, Rows (abstract)
│   └── Actions/   Button, Link, Menu
├── Filters/Filter.php
└── Support/
    ├── Toast.php
    ├── helpers.php                   ← toast(), meubleo_price(), meubleo_prefix()
    └── Facades/  Shop, Cart

stubs/app/Meubleo/               ← Published to app/Meubleo/ on install
    MeubleoServiceProvider.php
    Screens/Product/ProductListScreen.php
    Layouts/Product/ProductTableLayout.php
    Filters/ProductNameFilter.php
    routes/meubleo.php

Stripe test card

4242 4242 4242 4242 — any future date, any CVV.

License

MIT