PHPackages                             quantavoxel/laravel-bootstrap-component - 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. [Templating & Views](/categories/templating)
4. /
5. quantavoxel/laravel-bootstrap-component

ActiveLibrary[Templating & Views](/categories/templating)

quantavoxel/laravel-bootstrap-component
=======================================

A lightweight Laravel package offering reusable Bootstrap 5 Blade components, optimized asset bundling, and a highly flexible, universal icon integration system.

v1.1.0(2w ago)17MITJavaScriptPHP ^8.2

Since May 17Pushed 2w agoCompare

[ Source](https://github.com/QuantaVoxel/laravel-bootstrap-component)[ Packagist](https://packagist.org/packages/quantavoxel/laravel-bootstrap-component)[ RSS](/packages/quantavoxel-laravel-bootstrap-component/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (4)Dependencies (2)Versions (6)Used By (0)

Quantavoxel Laravel Bootstrap Component & Flexible Icon System
==================================================================

[](#quantavoxel-laravel-bootstrap-component--flexible-icon-system)

**Quantavoxel Bootstrap Component** is a standalone Laravel package engineered to drastically accelerate UI development using Bootstrap 5. It eliminates configuration overhead by combining ready-to-use, reusable Blade components, streamlined global asset management, and a highly scalable, universal icon engine—all out of the box.

### 🚀 Key Features & SEO Advantages:

[](#-key-features--seo-advantages)

- **Pre-compiled Assets & Zero Config:** All required CSS and JS bundles are baked directly into the package. Your main application is completely liberated from complex build tool configurations (Vite/Webpack).
- **Scalable Blade UI Components:** Rapidly build interface structures (navbars, sidebars, modals, alerts) utilizing standard, clean Laravel HTML syntax tags (``).
- **Universal Icon Integration Engine:** Powered by a flexible integration design. This package is completely future-proof—built to dynamically support thousands of icon sets (Solar Icons, Lucide, FontAwesome, Remix Icons, etc.) via a unified API, preventing vendor lock-in.
- **Developer-Centric Extensibility:** Easily customize, swap, or extend icon sets and global styles using a dedicated, publishable configuration file.

---

📦 Installation
--------------

[](#-installation)

You can install the package via composer:

```
composer require quantavoxel/laravel-bootstrap-component
```

### Publishing Assets and Configuration

[](#publishing-assets-and-configuration)

This package includes a comprehensive **Metronic-style dashboard** asset tree (approx. 90MB). You can publish the assets and configuration files separately or together:

**Publish Everything:**

```
php artisan vendor:publish --provider="Quantavoxel\LaravelBootstrapComponent\BootstrapComponentServiceProvider"
```

**Publish Only Assets:**

```
php artisan vendor:publish --tag="qv-component-assets"
```

**Publish Only Configuration:**

```
php artisan vendor:publish --tag="qv-component-config"
```

This will publish:

- Compiled CSS and JS assets to `public/vendor/quantavoxel/bootstrap-component`
- Configuration files to the `config/` directory.

---

🛠️ Usage & Layout Setup
---------------------------

[](#️-usage--layout-setup)

The package provides a ready-to-use dashboard layout that automatically integrates the sidebar, header, and required assets.

### Basic Layout Setup

[](#basic-layout-setup)

In your main Blade view (e.g., `resources/views/dashboard.blade.php`), simply wrap your content with the `` component:

```

                Hello, world!

```

This automatically sets up the HTML skeleton, Metronic theme styles, Iconify scripts, the Sidebar, and the Header.

#### Asset Management

[](#asset-management)

By default, the `@qvComponentStyles` and `@qvComponentScripts` directives (used internally by the dashboard component) load the bundled Metronic and Iconify assets. You can disable this automatic loading in the `config/bootstrap-component.php` file if you wish to include them in your own asset pipeline:

```
'load_assets' => false,
```

For detailed documentation on all available components (Buttons, Inputs, Modals, Cards, Avatars, etc.), please refer to the **[Component Documentation](docs/component.md)**.

---

⚙️ Configuration (Sidebar & Header)
---------------------------------------

[](#️-configuration-sidebar--header)

The package uses simple PHP configuration files to generate the dashboard navigation menus. You can find these files in your application's `config/` directory after publishing.

### Sidebar Configuration (`config/bootstrap-component-sidebar.php`)

[](#sidebar-configuration-configbootstrap-component-sidebarphp)

Use the provided helper functions (prefixed with `qv_` to avoid collisions) to easily build your sidebar structure:

- `qv_add_heading('Title')`
- `qv_add_single_menu('Title', 'icon-name', '/url')`
- `qv_add_accordion_menu('Title', 'icon-name', [ ...sub menus ])`
- `qv_add_sub_menu('Title', '/url')`

**Example:**

```