PHPackages                             bagistoplus/basic-blocks - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. bagistoplus/basic-blocks

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

bagistoplus/basic-blocks
========================

Basic blocks for bagisto visual editor

v1.1.0(1mo ago)0679↑15.5%[1 PRs](https://github.com/bagistoplus/blocks/pulls)MITPHPPHP ^8.2CI passing

Since May 4Pushed yesterdayCompare

[ Source](https://github.com/bagistoplus/blocks)[ Packagist](https://packagist.org/packages/bagistoplus/basic-blocks)[ Docs](https://github.com/bagistoplus/basic-blocks)[ GitHub Sponsors](https://github.com/BagistoPlus)[ RSS](/packages/bagistoplus-basic-blocks/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (4)Dependencies (14)Versions (3)Used By (0)

Basic Blocks for Bagisto Visual Editor
======================================

[](#basic-blocks-for-bagisto-visual-editor)

[![Latest Version on Packagist](https://camo.githubusercontent.com/46c6ae1ad7c561948a2167bbc898a5a939538b53ad5111578ad2a8157b912218/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6261676973746f706c75732f62617369632d626c6f636b732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bagistoplus/basic-blocks)[![GitHub Tests Action Status](https://camo.githubusercontent.com/4b976d33ec6a7abfe61123039b5428143b37e5aece8c5f8f7755afdb655f840c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6261676973746f706c75732f626c6f636b732f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/bagistoplus/blocks/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/68fd2a1a6f2ce2a267b887f65cc2f4d1839a82cd983b77c31c40ef3dc2a665a4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f6261676973746f706c75732f626c6f636b732f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/bagistoplus/blocks/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/7147a76142c949071e4893b655b6e2309314fe9c15bd0a7fe79a278744c89d2d/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6261676973746f706c75732f62617369632d626c6f636b732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/bagistoplus/basic-blocks)

A collection of essential, ready-to-use blocks for the [Bagisto Visual Editor](https://visual.bagistoplus.com). This package provides foundational building blocks for professional Bagisto storefronts. It comes pre-installed with fresh Bagisto visual themes, enabling drag-and-drop page building without writing code.

Blocks are built with Laravel Blade templates, styled with Tailwind CSS, and enhanced with Alpine.js for interactivity. Some blocks also leverage Livewire for dynamic functionality.

Installation
------------

[](#installation)

This package comes pre-installed with fresh Bagisto visual themes. If you need to install it manually, you can do so via composer:

```
composer require bagistoplus/basic-blocks
```

That's it! The package will automatically register itself via Laravel's package auto-discovery.

Usage
-----

[](#usage)

This package provides basic blocks for the Bagisto Visual Editor. Once installed, the blocks are automatically available in the visual editor interface at [visual.bagistoplus.com](https://visual.bagistoplus.com).

Simply use the drag-and-drop interface to add blocks to your pages and customize them through the visual editor.

Host Theme Integration
----------------------

[](#host-theme-integration)

Most blocks work with zero configuration. This package also ships an optional shared stylesheet entry for packaged block styles.

### Shared stylesheet (optional)

[](#shared-stylesheet-optional)

Themes can import the package stylesheet entry:

```
@import '../../../vendor/bagistoplus/basic-blocks/resources/assets/css/index.css';
```

Adjust the relative path to match your theme's CSS file location.

This file contains the packaged block CSS (including button styles) and Tailwind source hints used by those styles.

For button customization, override the button CSS custom properties (`--btn-radius`, `--btn-border-width`, `--btn-font-size`, `--btn-letter-spacing`, `--btn-text-transform`, and the shadow/inset variables). The full list is in [resources/assets/css/index.css](resources/assets/css/index.css).

If the stylesheet is not imported, blocks still function; packaged visual styles are simply not applied.

### Icon block

[](#icon-block)

No setup is required. The `bagistoplus/visual` package every Bagisto visual theme depends on already registers `blade-ui-kit/blade-icons` along with the Lucide and Heroicons sets, so the default `lucide-*` icons work out of the box.

**Optional**: theme developers who want additional icon sets (e.g. Tabler, Feather) can `composer require` them in the theme. Any set registered with blade-icons becomes selectable in the Icon block from the visual editor.

Technology Stack
----------------

[](#technology-stack)

The blocks in this package are built using:

- **Laravel Blade** - For templating and server-side rendering
- **Tailwind CSS** - For modern, utility-first styling
- **Alpine.js** - For lightweight JavaScript interactivity
- **Livewire** - For dynamic, reactive components (used in select blocks)

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Eldo Magan](https://github.com/bagistoplus)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

45

—

FairBetter than 91% of packages

Maintenance97

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

2

Last Release

35d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8585729?v=4)[Eldo Magan](/maintainers/eldomagan)[@eldomagan](https://github.com/eldomagan)

---

Top Contributors

[![eldomagan](https://avatars.githubusercontent.com/u/8585729?v=4)](https://github.com/eldomagan "eldomagan (51 commits)")

---

Tags

laravelecommercevisual editorblocksbagistobagisto extensionbagisto themeBagistoPlus

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/bagistoplus-basic-blocks/health.svg)

```
[![Health](https://phpackages.com/badges/bagistoplus-basic-blocks/health.svg)](https://phpackages.com/packages/bagistoplus-basic-blocks)
```

###  Alternatives

[psalm/plugin-laravel

Psalm plugin for Laravel

3325.1M337](/packages/psalm-plugin-laravel)[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

327482.0k25](/packages/codewithdennis-filament-select-tree)[bagistoplus/visual

Bagisto theme framework and visual theme editor

708.3k4](/packages/bagistoplus-visual)[nativephp/desktop

NativePHP for Desktop

37833.6k8](/packages/nativephp-desktop)[linkxtr/laravel-qrcode

A clean, modern, and easy-to-use QR code generator for Laravel

3614.9k](/packages/linkxtr-laravel-qrcode)[tomshaw/electricgrid

A feature-rich Livewire package designed for projects that require dynamic, interactive data tables.

119.2k](/packages/tomshaw-electricgrid)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
