Skip to content

Getting Started

Bagisto Visual gives you a full visual editing experience for your storefront — with real-time preview, drag-and-drop sections, and theme customization.

This guide will help you:

  1. Install Bagisto Visual
  2. Add the default starter theme
  3. Launch the visual editor
  4. Add and edit content
  5. Create your first custom section

Prerequisites

Before you begin, make sure you have:

  • PHP version 8.1 or later
  • A running Bagisto store (version 2.2.0 or later)

Step 1: Install Bagisto Visual

Install the package via Composer:

bash
composer require bagistoplus/visual

Then publish the assets:

bash
php artisan vendor:publish --tag=visual-assets

This installs the Bagisto Visual and prepares your store for theme customization.

Step 2: Install the Starter Theme

Install the default theme package:

bash
composer require bagistoplus/visual-debut

And publish it's assets:

bash
php artisan vendor:publish --tag=visual-debut-assets

Once installed, the theme will appear in your Bagisto admin under the menu Bagisto Visual -> Themes.

Click Customize to launch the visual editor.

Step 3: Launch the Visual Editor

When you open the editor, you’ll see:

  • A live preview of your storefront
  • Sidebar with section layout and content
  • Tools to change language, screen size, and pages

You can now:

  • Add new sections to the page
  • Rearrange them
  • Click a section to edit its settings

ℹ️ For a full breakdown of the interface, see Theme Editor: Interface Guide

Step 4: Add and Edit Sections

To add a new section:

  1. Click Add Section in the sidebar
  2. Choose a section like Hero, Newsletter, or Featured Products
  3. Click on the section to customize its settings (text, images, links)
  4. Changes appear instantly in the preview

Step 5: Create a Custom Section

To build your own section, use the following Artisan command:

bash
php artisan visual:make-section MyBanner

This creates:

  • A PHP class at: app/Visual/Sections/MyBanner.php
  • A Blade file at: resources/views/sections/my-banner.blade.php

You can now edit the view and class to define your own settings and layout.

🧱 To go deeper, see Creating Sections

What’s Next?


You’re ready to build a beautiful, customized storefront — visually.

Released under the MIT License.