PHPackages                             maestriam/samurai - 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. maestriam/samurai

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

maestriam/samurai
=================

Create awsome themes for your Laravel projects.

v3.1.7(1y ago)51061GPL-3.0PHP

Since Apr 16Pushed 1y ago1 watchersCompare

[ Source](https://github.com/maestriam/samurai)[ Packagist](https://packagist.org/packages/maestriam/samurai)[ RSS](/packages/maestriam-samurai/feed)WikiDiscussions master Synced 4d ago

READMEChangelogDependencies (5)Versions (15)Used By (1)

 [![maestriam/samurai logo](imgs/samurai.png)](imgs/samurai.png)

🔴 maestriam/samurai
===================

[](#-maestriamsamurai)

 Create awesome themes for your Laravel projects.

[![Travis (.com)](https://camo.githubusercontent.com/35293e9c4dfc0cd2ce9b88f9c66aae47e41acb435a388c942f456ddce67aabc9/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f6d616573747269616d2f73616d757261693f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/35293e9c4dfc0cd2ce9b88f9c66aae47e41acb435a388c942f456ddce67aabc9/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f636f6d2f6d616573747269616d2f73616d757261693f7374796c653d666c61742d737175617265)[![Scrutinizer Code Quality](https://camo.githubusercontent.com/21aab0ba0383526615ab0e5208206f73c215fbf41aebb73dab07c9f16a6d6513/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f7175616c6974792f672f6d616573747269616d2f73616d757261692f6d61737465723f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/maestriam/samurai/?branch=master)[![GitHub Last Commit](https://camo.githubusercontent.com/21e299fcba7ab7a81871897bd84d7223dc8d32b898797826b69735acbbac0d8d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6d616573747269616d2f73616d757261693f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/21e299fcba7ab7a81871897bd84d7223dc8d32b898797826b69735acbbac0d8d/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6173742d636f6d6d69742f6d616573747269616d2f73616d757261693f7374796c653d666c61742d737175617265)

**Maestriam/Samurai** is a simple package for creating and managing themes for Laravel applications, using [component](https://laravel.com/docs/5.8/blade#components-and-slots) and [include](https://laravel.com/docs/5.8/blade#including-sub-views) functions of Laravel Blade.
You can publishing your themes and install-it in another projects using composer.

Requirements
------------

[](#requirements)

- Laravel 8.\*^

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

[](#installation)

**Install via composer**

```
composer require maestriam/samurai
```

**Publish samurai.php into config folder**

```
php artisan vendor:publish --tag=Samurai
```

Getting Started
---------------

[](#getting-started)

To create a new theme

```
php artisan samurai:make-init
```

**Creating a new theme with default configs**

```
php artisan samurai:make-theme my-vendor/my-theme
```

**Creating a new include**

```
php artisan samurai:make-include my-include my-vendor/my-theme
```

The `theme` param is optional. If not informed, assume the default theme automatically.
To edit your include file, go to themes/my-vendor/my-theme/src/my-include/my-include-include.blade.php

**Creating a new component**

```
php artisan samurai:make-component my-component my-vendor/my-theme
```

The `theme` param is optional. If not informed, assume the default theme automatically.
To edit your include file, go to themes/my-vendor/my-theme/src/my-component/my-component-component.blade.php

**Using theme in your project**
To publish your assets and define your theme as current:

```
php artisan samurai:use my-vendor/my-theme
```

**Using components into blade files**
To use component in your view.blade.php, use:

```
@myComponent()

    My content inside

@endmyComponent()
```

Now, also, you can use Blade UI notation too:

```

    My content inside

```

**Using includes into blade files**
To use include in your view.blade.php, use:

```
@myInclude()
```

Now, also, you can use Blade UI notation too:

```

```

**Load assets into theme files**
To import any file into your theme(like css, js, imgs), use directive @public.
E.g:

```

```

Created by [Giuliano Sampaio](https://github.com/giusampaio) with ❤️, ☕ and 🍺!

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity63

Established project with proven stability

 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 ~137 days

Recently: every ~121 days

Total

13

Last Release

573d ago

Major Versions

v1.2.2 → v2.0.12020-07-05

v2.0.1 → v3.0.02021-07-13

### Community

Maintainers

![](https://www.gravatar.com/avatar/3be54af44786252af41a2269b0d596949b2d8f22839839e5907e211559f945c8?d=identicon)[giusampaio](/maintainers/giusampaio)

---

Top Contributors

[![giusampaio](https://avatars.githubusercontent.com/u/899890?v=4)](https://github.com/giusampaio "giusampaio (87 commits)")

---

Tags

laravelphp

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/maestriam-samurai/health.svg)

```
[![Health](https://phpackages.com/badges/maestriam-samurai/health.svg)](https://phpackages.com/packages/maestriam-samurai)
```

###  Alternatives

[cagilo/cagilo

A set of open-source Blade components for the Laravel Framework

172996.5k](/packages/cagilo-cagilo)[orchid/blade-icons

An easy way inline SVG images in your Blade templates.

223.4M9](/packages/orchid-blade-icons)[wireui/heroicons

The Tailwind Heroicons for laravel blade by WireUI

43390.8k5](/packages/wireui-heroicons)[stillat/antlers-components

2656.0k1](/packages/stillat-antlers-components)[itstructure/laravel-grid-view

Grid view for laravel framework

2546.6k2](/packages/itstructure-laravel-grid-view)[ycs77/inertia-laravel-ssr-head

Simple SSR Head for Inertia Laravel

3211.5k](/packages/ycs77-inertia-laravel-ssr-head)

PHPackages © 2026

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