PHPackages                             mkocansey/bladewind - 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. mkocansey/bladewind

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

mkocansey/bladewind
===================

BladewindUI — elegant Laravel Blade UI components powered by TailwindCSS

v4.2.1(1w ago)683123.5k↓50%65[13 issues](https://github.com/mkocansey/bladewind/issues)MITJavaScriptPHP >=8.1CI passing

Since May 15Pushed 1w ago9 watchersCompare

[ Source](https://github.com/mkocansey/bladewind)[ Packagist](https://packagist.org/packages/mkocansey/bladewind)[ RSS](/packages/mkocansey-bladewind/feed)WikiDiscussions main Synced 2d ago

READMEChangelog (10)Dependencies (2)Versions (149)Used By (0)

[![License](https://camo.githubusercontent.com/ead282baa36c95c0a46cca5c9f0404c81b70cd523f8d3949a9f7d5ea8570475a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6b6f63616e7365792f626c61646577696e64)](https://camo.githubusercontent.com/ead282baa36c95c0a46cca5c9f0404c81b70cd523f8d3949a9f7d5ea8570475a/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d6b6f63616e7365792f626c61646577696e64)

[![](https://camo.githubusercontent.com/2e5420b83a0b4ad1383e047b06317da183a0e71c7903e270e430ee215c32ac02/68747470733a2f2f626c61646577696e6475692e636f6d2f6173736574732f696d616765732f62772d6c6f676f2e706e67)](https://camo.githubusercontent.com/2e5420b83a0b4ad1383e047b06317da183a0e71c7903e270e430ee215c32ac02/68747470733a2f2f626c61646577696e6475692e636f6d2f6173736574732f696d616765732f62772d6c6f676f2e706e67)

BladewindUI is a collection of UI components built with TailwindCSS, Laravel Blade templates, and vanilla JavaScript. Every component is simple to use and ships with sensible defaults you can override per-project.

Installation
============

[](#installation)

### Install everything (recommended starting point)

[](#install-everything-recommended-starting-point)

This pulls in all components.

```
composer require mkocansey/bladewind
```

### Install a component group

[](#install-a-component-group)

Each logical group is available as its own package. Install a group when you only need a subset of BladewindUI:

```
composer require mkocansey/bladewind-forms       # all form components
composer require mkocansey/bladewind-content     # all content & display components
composer require mkocansey/bladewind-navigation  # all navigation components
```

### Install a single component

[](#install-a-single-component)

Every component is its own Composer package. Install exactly what you need.

```
composer require mkocansey/bladewind-table
composer require mkocansey/bladewind-accordion
composer require mkocansey/bladewind-datepicker
```

Shared dependencies (icon, script, spinner, etc.) are pulled in automatically via Composer's dependency resolution.

First-time setup
----------------

[](#first-time-setup)

After installing, publish the compiled CSS, JavaScript, and language files:

```
php artisan vendor:publish --tag=bladewind-public --force
php artisan vendor:publish --tag=bladewind-lang --force
```

Add the stylesheet to the `` of your layout:

```

```

Add the JavaScript before the closing `` tag:

```

```

You are ready to use any component:

```
Save User
```

Full installation guide: [bladewindui.com/install](https://bladewindui.com/install)

Components
----------

[](#components)

Components are organised into groups. Each group maps directly to a Composer package. Standalone packages (Button, Modal, Alert, Bell, Notification, Table, Spinner) sit outside any group.

### Standalone packages

[](#standalone-packages)

These components are their own packages and are not bundled into any group. They are pulled in as dependencies by other components that need them.

PackageComposer nameComponent(s)Core`mkocansey/bladewind-core`Shared helpers, CSS variables, `helpers.js`[Icon](https://bladewindui.com/component/icon)`mkocansey/bladewind-icon`SVG icon wrapper (Heroicons)[Alert](https://bladewindui.com/component/alert)`mkocansey/bladewind-alert`Alert[Bell](https://bladewindui.com/component/bell)`mkocansey/bladewind-bell`Bell[Button](https://bladewindui.com/component/button)`mkocansey/bladewind-button`Button, Circle Button[Modal](https://bladewindui.com/component/modal)`mkocansey/bladewind-modal`Modal, Modal Icon[Notification](https://bladewindui.com/component/notification)`mkocansey/bladewind-notification`Notification[Spinner](https://bladewindui.com/component/spinner)`mkocansey/bladewind-spinner`Spinner, Shimmer, Processing, Process Complete[Table](https://bladewindui.com/component/table)`mkocansey/bladewind-table`Table, Table Icons### Forms group — `mkocansey/bladewind-forms`

[](#forms-group--mkocanseybladewind-forms)

```
composer require mkocansey/bladewind-forms

# or install any single component
composer require mkocansey/bladewind-input
composer require mkocansey/bladewind-datepicker
...
```

PackageComposer nameComponent(s)[Checkbox](https://bladewindui.com/component/checkbox)`mkocansey/bladewind-checkbox`Checkbox[Checkcards](https://bladewindui.com/component/checkcard)`mkocansey/bladewind-checkcards`Checkcards, Checkcard[Colorpicker](https://bladewindui.com/component/colorpicker)`mkocansey/bladewind-colorpicker`Colorpicker[Datepicker](https://bladewindui.com/component/datepicker)`mkocansey/bladewind-datepicker`Datepicker[Filepicker](https://bladewindui.com/component/filepicker)`mkocansey/bladewind-filepicker`Filepicker (powered by FilePond)[Input](https://bladewindui.com/component/input)`mkocansey/bladewind-input`Input, Error[Number](https://bladewindui.com/component/number)`mkocansey/bladewind-number`Number stepper[Radio Button](https://bladewindui.com/component/radio-button)`mkocansey/bladewind-radio`Radio Button[Select](https://bladewindui.com/component/select)`mkocansey/bladewind-select`Select, Select Item[Slider](https://bladewindui.com/component/slider)`mkocansey/bladewind-slider`Slider[Textarea](https://bladewindui.com/component/textarea)`mkocansey/bladewind-textarea`Textarea[Timepicker](https://bladewindui.com/component/timepicker)`mkocansey/bladewind-timepicker`Timepicker[Toggle](https://bladewindui.com/component/toggle)`mkocansey/bladewind-toggle`Toggle[Verification Code](https://bladewindui.com/component/verification-code)`mkocansey/bladewind-code`Verification Code / OTP### Content group — `mkocansey/bladewind-content`

[](#content-group--mkocanseybladewind-content)

```
composer require mkocansey/bladewind-content

# or install any single component
composer require mkocansey/bladewind-accordion
composer require mkocansey/bladewind-chart
...
```

PackageComposer nameComponent(s)[Accordion](https://bladewindui.com/component/accordion)`mkocansey/bladewind-accordion`Accordion, Accordion Item[Avatar](https://bladewindui.com/component/avatar)`mkocansey/bladewind-avatar`Avatar, Avatars[Card](https://bladewindui.com/component/card)`mkocansey/bladewind-card`Card, Contact Card[Centered Content](https://bladewindui.com/component/centered-content)`mkocansey/bladewind-centered-content`Centered Content[Chart](https://bladewindui.com/component/chart)`mkocansey/bladewind-chart`Chart (line, bar, pie, donut)[Contact Card](https://bladewindui.com/component/contact-card)`mkocansey/bladewind-contact-card`Contact Card[Empty State](https://bladewindui.com/component/empty-state)`mkocansey/bladewind-empty-state`Empty State[Horizontal Line Graph](https://bladewindui.com/component/horizontal-line-graph)`mkocansey/bladewind-horizontal-line-graph`Horizontal Line Graph[List View](https://bladewindui.com/component/list-view)`mkocansey/bladewind-listview`List View, List View Item[Popover](https://bladewindui.com/component/popover)`mkocansey/bladewind-popover`Popover[Progress](https://bladewindui.com/component/progress-bar)`mkocansey/bladewind-progress`Progress Bar, Progress Circle[Rating](https://bladewindui.com/component/rating)`mkocansey/bladewind-rating`Rating[Sortable](https://bladewindui.com/component/sortable)`mkocansey/bladewind-sortable`Sortable, Sortable Item[Statistic](https://bladewindui.com/component/statistic)`mkocansey/bladewind-statistic`Statistic[Tag](https://bladewindui.com/component/tag)`mkocansey/bladewind-tag`Tag, Tags[Timeline](https://bladewindui.com/component/timeline)`mkocansey/bladewind-timeline`Timeline, Timelines[Tooltip](https://bladewindui.com/component/tooltip)`mkocansey/bladewind-tooltip`Tooltip### Navigation group — `mkocansey/bladewind-navigation`

[](#navigation-group--mkocanseybladewind-navigation)

```
composer require mkocansey/bladewind-navigation

# or install any single component
composer require mkocansey/bladewind-tab
composer require mkocansey/bladewind-pagination
...
```

PackageComposer nameComponent(s)[Dropmenu](https://bladewindui.com/component/dropmenu)`mkocansey/bladewind-dropmenu`Dropmenu, Dropmenu Item[Pagination](https://bladewindui.com/component/pagination)`mkocansey/bladewind-pagination`Pagination[Tab](https://bladewindui.com/component/tab)`mkocansey/bladewind-tab`Tab, Tab Body, Tab Content, Tab Heading[Theme Switcher](https://bladewindui.com/component/theme-switcher)`mkocansey/bladewind-theme-switcher`Theme Switcher (light / dark)How groups work
---------------

[](#how-groups-work)

The three group packages (`bladewind-forms`, `bladewind-content`, `bladewind-navigation`) contain **no code** — they are pure Composer metapackages whose only job is to pull in the right leaf packages. This means:

- Installing `mkocansey/bladewind-content` is identical to installing every content leaf package individually.
- Uninstalling it and requiring just `mkocansey/bladewind-accordion` is clean and leaves nothing behind.
- Each leaf package registers its own Laravel service provider, so components are auto-discovered whether you install them individually or as part of a group.

Customising defaults
--------------------

[](#customising-defaults)

Publish the config file (available when using the full `mkocansey/bladewind` package):

```
php artisan vendor:publish --tag=bladewind-config
```

This creates `config/bladewind.php` in your project. Every attribute in every component has a default defined here. Override them once and all component instances in your project will follow suit.

Full customisation guide: [bladewindui.com/customize](https://bladewindui.com/customize)

Documentation
-------------

[](#documentation)

The complete documentation with extensive examples for each component is available at [bladewindui.com](https://bladewindui.com)

Questions and support
---------------------

[](#questions-and-support)

- Email:
- Twitter / X: [@bladewindui](https://twitter.com/bladewindui)
- Security vulnerabilities: please e-mail rather than opening a public issue

License
-------

[](#license)

BladewindUI is open-sourced software licensed under the [MIT licence](https://opensource.org/licenses/MIT).

###  Health Score

68

—

FairBetter than 99% of packages

Maintenance97

Actively maintained with recent releases

Popularity55

Moderate usage in the ecosystem

Community29

Small or concentrated contributor base

Maturity75

Established project with proven stability

 Bus Factor1

Top contributor holds 91.5% 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 ~11 days

Recently: every ~50 days

Total

132

Last Release

12d ago

Major Versions

v0.1.9 → v1.0.02022-05-28

v1.4.9 → v2.0.02022-12-30

v2.9.0 → v3.0.02025-04-14

v3.3.0 → 4.0.02026-06-07

PHP version history (3 changes)v0.1.0PHP >=7.3

v3.0.0PHP >=8.0

4.0.0PHP >=8.1

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1946332?v=4)[Michael K. Ocansey](/maintainers/mkocansey)[@mkocansey](https://github.com/mkocansey)

---

Top Contributors

[![mkocansey](https://avatars.githubusercontent.com/u/1946332?v=4)](https://github.com/mkocansey "mkocansey (757 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (28 commits)")[![prince-noman](https://avatars.githubusercontent.com/u/67705630?v=4)](https://github.com/prince-noman "prince-noman (5 commits)")[![haugen86](https://avatars.githubusercontent.com/u/620820?v=4)](https://github.com/haugen86 "haugen86 (5 commits)")[![ntbutler-nbcs](https://avatars.githubusercontent.com/u/94018771?v=4)](https://github.com/ntbutler-nbcs "ntbutler-nbcs (4 commits)")[![felixfrey](https://avatars.githubusercontent.com/u/6955297?v=4)](https://github.com/felixfrey "felixfrey (3 commits)")[![berrugo](https://avatars.githubusercontent.com/u/10728169?v=4)](https://github.com/berrugo "berrugo (3 commits)")[![TiBiBa](https://avatars.githubusercontent.com/u/38155424?v=4)](https://github.com/TiBiBa "TiBiBa (2 commits)")[![HarriFent](https://avatars.githubusercontent.com/u/28115257?v=4)](https://github.com/HarriFent "HarriFent (2 commits)")[![rezgui](https://avatars.githubusercontent.com/u/1289096?v=4)](https://github.com/rezgui "rezgui (2 commits)")[![BeBel42](https://avatars.githubusercontent.com/u/64377698?v=4)](https://github.com/BeBel42 "BeBel42 (2 commits)")[![datlechin](https://avatars.githubusercontent.com/u/56961917?v=4)](https://github.com/datlechin "datlechin (2 commits)")[![malikdoksoz](https://avatars.githubusercontent.com/u/26676061?v=4)](https://github.com/malikdoksoz "malikdoksoz (1 commits)")[![AlexsanderF](https://avatars.githubusercontent.com/u/23175002?v=4)](https://github.com/AlexsanderF "AlexsanderF (1 commits)")[![DatIsVinnie](https://avatars.githubusercontent.com/u/57494611?v=4)](https://github.com/DatIsVinnie "DatIsVinnie (1 commits)")[![j2deme](https://avatars.githubusercontent.com/u/1148641?v=4)](https://github.com/j2deme "j2deme (1 commits)")[![kalirocket](https://avatars.githubusercontent.com/u/61436567?v=4)](https://github.com/kalirocket "kalirocket (1 commits)")[![adambinnersley](https://avatars.githubusercontent.com/u/1990042?v=4)](https://github.com/adambinnersley "adambinnersley (1 commits)")[![malozaibi](https://avatars.githubusercontent.com/u/19515597?v=4)](https://github.com/malozaibi "malozaibi (1 commits)")[![MMuslimAbdulJ](https://avatars.githubusercontent.com/u/83753102?v=4)](https://github.com/MMuslimAbdulJ "MMuslimAbdulJ (1 commits)")

---

Tags

bladecsshacktoberfesthtmljavascriptlaravellaravel-packagephptailwindcssuiui-componentsui-designui-librarylaravelbladetailwindcssui-componentsbladewindui

### Embed Badge

![Health badge](/badges/mkocansey-bladewind/health.svg)

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

###  Alternatives

[hasinhayder/tyro-dashboard

Tyro Dashboard - Beautiful admin dashboard for managing Tyro roles, privileges, users, and settings

5443.8k](/packages/hasinhayder-tyro-dashboard)[technikermathe/blade-lucide-icons

A package to easily make use of Lucide icons in your Laravel Blade views.

18421.4k11](/packages/technikermathe-blade-lucide-icons)[developermithu/tallcraftui

TallCraftUI is a Laravel blade UI components library built on TALL stack

1663.3k](/packages/developermithu-tallcraftui)[hasinhayder/tyro-login

Tyro Login - Beautiful, customizable authentication views for Laravel 12 & 13

2464.9k6](/packages/hasinhayder-tyro-login)[ublabs/blade-simple-icons

A package to easily make use of Simple Icons in your Laravel Blade views.

1963.4k](/packages/ublabs-blade-simple-icons)

PHPackages © 2026

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