PHPackages                             get-tony/bal-kit - 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. [Authentication &amp; Authorization](/categories/authentication)
4. /
5. get-tony/bal-kit

ActiveLibrary[Authentication &amp; Authorization](/categories/authentication)

get-tony/bal-kit
================

Complete BAL Kit starter for Laravel - Bootstrap + Alpine.js + Livewire with air-gapped authentication system, professional UI components, and 7-1 SASS architecture. Perfect for enterprise and secure environments.

v1.5.2(11mo ago)019proprietaryBladePHP ^8.2CI passing

Since Jun 15Pushed 11mo agoCompare

[ Source](https://github.com/Get-Tony/bal-kit)[ Packagist](https://packagist.org/packages/get-tony/bal-kit)[ Docs](https://github.com/get-tony/bal-kit)[ RSS](/packages/get-tony-bal-kit/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (7)Versions (4)Used By (0)

Laravel BAL Kit
===============

[](#laravel-bal-kit)

[![Latest Version on Packagist](https://camo.githubusercontent.com/a73e2fdcf534e553035a2a410236cb983e486f6c2a92ea548d2df32bfd7c020e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6765742d746f6e792f62616c2d6b69742e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/get-tony/bal-kit)[![License: Proprietary](https://camo.githubusercontent.com/41e639cac81d867e862c30b25ebe94d6bb044255bfff41f12a03d0f0f056d9c9/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c6963656e73652d50726f70726965746172792d7265642e737667)](https://github.com/get-tony/bal-kit/blob/main/LICENSE)[![Laravel](https://camo.githubusercontent.com/edcedeaaf8f3211fc3e8eab295467455dd1d9d1ff594e2678eb4638782be54a4/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d313025324225323025374325323031322d7265642e737667)](https://laravel.com)[![PHP](https://camo.githubusercontent.com/0f16581d1180dbfd4c0e13166ec1267d4ad2f2fab8281ea6d6b284cf5c65d921/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75652e737667)](https://php.net)[![Version](https://camo.githubusercontent.com/0b07e19cce7b0e2482a493189c197449fb45d4c6235a3a58bc0b2de3395497ce/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f56657273696f6e2d312e352e32253230537461626c652d677265656e2e737667)](https://github.com/get-tony/bal-kit/releases/tag/v1.5.2)

A production-ready Laravel starter kit with **Bootstrap 5**, **Alpine.js**, and **Livewire 3** - the professional alternative to TALL stack for developers who prefer Bootstrap over Tailwind CSS.

✨ What is BAL Kit?
------------------

[](#-what-is-bal-kit)

**BAL Kit** = **B**ootstrap + **A**lpine + **L**ivewire

A complete starter kit featuring:

- 🎨 **Bootstrap 5** - Professional UI components and responsive design
- 🏔️ **Alpine.js** - Lightweight reactivity (~15kB)
- ⚡ **Livewire 3** - Dynamic components without leaving PHP
- 🏗️ **7-1 SASS Architecture** - Organized, maintainable stylesheets
- 🔐 **Complete Authentication** - Login, registration, dashboard, profile management
- 🧩 **Reusable Components** - Professional Blade components ready to use

🚀 Quick Start
-------------

[](#-quick-start)

### New Project

[](#new-project)

```
composer create-project laravel/laravel my-app
cd my-app
composer require get-tony/bal-kit
php artisan bal:install --preset=full
npm install && npm run build
php artisan serve
```

### Existing Project

[](#existing-project)

```
composer require get-tony/bal-kit
php artisan bal:install --preset=standard
npm install && npm run build
```

🎯 What You Get
--------------

[](#-what-you-get)

- **Authentication System** - Complete login, registration, and password reset
- **Admin Dashboard** - Modern dashboard with statistics and activity feeds
- **Profile Management** - Multi-tab profile settings with security options
- **Professional Components** - Cards, buttons, alerts, modals with extensive customization
- **Bootstrap Showcase** - Comprehensive demo of all Bootstrap 5.3+ components

🔧 System Requirements
---------------------

[](#-system-requirements)

- **Laravel 10+ or 12+**
- **PHP 8.2+**
- **Node.js 18+** and **NPM**
- **Composer 2.0+**

> **Note:** All dependencies are automatically installed and configured.

📚 Documentation
---------------

[](#-documentation)

### Quick Links

[](#quick-links)

- **[📖 Complete Documentation](docs/README.md)** - Comprehensive guides and examples
- **[🚀 Installation Guide](docs/installation.md)** - Detailed installation options
- **[⚙️ Configuration](docs/configuration.md)** - Customize settings and behavior
- **[🎨 Usage Examples](docs/usage-examples.md)** - Code examples and patterns
- **[🔧 Customization](docs/customization.md)** - Modify and extend components

### Installation Presets

[](#installation-presets)

```
# Minimal (Bootstrap + Alpine only)
php artisan bal:install --preset=minimal

# Standard (+ Livewire + SASS)
php artisan bal:install --preset=standard

# Full (+ Authentication)
php artisan bal:install --preset=full
```

### Your First Component

[](#your-first-component)

```

            Your Bootstrap + Alpine.js + Livewire application is ready.

                Show Toast

```

🧪 Testing &amp; Quality Assurance
---------------------------------

[](#-testing--quality-assurance)

### Testing

[](#testing)

```
# Run all tests locally
./test

# Test specific components
./test phpunit
./test frontend
./test composer
```

**[📋 Complete Testing Guide](docs/testing.md)** - Comprehensive testing documentation

⚠️ Important Notes
------------------

[](#️-important-notes)

- **Do not run `php artisan breeze:install` manually** - BAL Kit handles authentication setup automatically with the `--preset=full` option
- **Use SASS, not CSS** - BAL Kit uses a 7-1 SASS architecture instead of plain CSS files
- **Bootstrap over Tailwind** - BAL Kit is designed as a Bootstrap alternative to TALL stack packages

⚖️ License &amp; Commercial Use
-------------------------------

[](#️-license--commercial-use)

**BAL Kit is proprietary software.** You may examine the source code for evaluation, but commercial use requires a license.

**For production or commercial projects:** Contact

🌟 Key Features
--------------

[](#-key-features)

### ✅ Production Ready (v1.5.0)

[](#-production-ready-v150)

- **Comprehensive Testing** - Complete test suite for quality assurance
- **Air-Gapped Friendly** - No external dependencies
- **Enterprise Security** - Perfect for secure/isolated environments
- **Universal Compatibility** - Works with Laravel 10+, 11+, 12+

### 🎨 Professional UI

[](#-professional-ui)

- **Bootstrap 5.3+** - Latest components and utilities
- **7-1 SASS Architecture** - Organized, maintainable stylesheets
- **Responsive Design** - Mobile-first approach
- **System Fonts** - No external font dependencies

### ⚡ Modern Stack

[](#-modern-stack)

- **Livewire 3** - Dynamic server-side components
- **Alpine.js** - Lightweight client-side reactivity
- **Vite Integration** - Fast builds and hot reload
- **PHPUnit Ready** - Comprehensive test coverage

🚀 Version 1.5.2 Highlights
--------------------------

[](#-version-152-highlights)

- 🔧 **Breeze Integration Fix** - Resolved CSS/SASS conflicts during installation
- 🚀 **Seamless Installation** - `--preset=full` now works without errors
- 📚 **Improved Documentation** - Clear warnings about manual Breeze installation
- 🛡️ **Conflict Prevention** - Automatic detection and resolution of asset conflicts
- ⚡ **Better Error Handling** - Clear guidance when installation issues occur

📞 Support &amp; Resources
-------------------------

[](#-support--resources)

### 📚 Documentation

[](#-documentation-1)

- **[Complete Documentation](docs/)** - Comprehensive guides
- **[Installation Guide](docs/installation.md)** - Step-by-step setup
- **[Testing Guide](docs/testing.md)** - Comprehensive testing
- **[Troubleshooting](docs/troubleshooting.md)** - Common issues

### 🔗 Links

[](#-links)

- **[Packagist](https://packagist.org/packages/get-tony/bal-kit)** - Official package
- **[GitHub](https://github.com/get-tony/bal-kit)** - Source code
- **[Email Support](mailto:get-tony@outlook.com)** - Direct support

---

**Ready to get started?** Check out the [Installation Guide](docs/installation.md) or run `./test` to see BAL Kit in action!

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance52

Moderate activity, may be stable

Popularity6

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity51

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

3

Last Release

336d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/5fc91120461c3632dff3063517e3af945b4000c655e2b27d37198f134f916210?d=identicon)[Get-Tony](/maintainers/Get-Tony)

---

Top Contributors

[![Get-Tony](https://avatars.githubusercontent.com/u/24943051?v=4)](https://github.com/Get-Tony "Get-Tony (32 commits)")

---

Tags

air-gap-compatiblebootstrap5laravel-12laravel-bootstrap-starter-kitlaravel-livewiresystem-fontslaraveluiAuthenticationcomponentssasslivewiresecurebootstrapenterprisefrontendstarteralpinekitalpinejsofflinetall-stackair-gapped

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/get-tony-bal-kit/health.svg)

```
[![Health](https://phpackages.com/badges/get-tony-bal-kit/health.svg)](https://phpackages.com/packages/get-tony-bal-kit)
```

###  Alternatives

[laravel/ui

Laravel UI utilities and presets.

2.7k134.9M601](/packages/laravel-ui)[livewire/flux

The official UI component library for Livewire.

9385.0M86](/packages/livewire-flux)[robsontenorio/mary

Gorgeous UI components for Livewire powered by daisyUI and Tailwind

1.5k454.7k15](/packages/robsontenorio-mary)[auth0/login

Auth0 Laravel SDK. Straight-forward and tested methods for implementing authentication, and accessing Auth0's Management API endpoints.

2745.0M3](/packages/auth0-login)[andrewdwallo/filament-companies

A comprehensive Laravel authentication and authorization system designed for Filament, focusing on multi-tenant company management.

34450.0k2](/packages/andrewdwallo-filament-companies)[ympact/flux-icons

A package to provide icons from different vendors for Livewire Flux.

116.2k](/packages/ympact-flux-icons)

PHPackages © 2026

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