Download the PHP package alizharb/flare without Composer
On this page you can find all versions of the php package alizharb/flare. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download alizharb/flare
More information about alizharb/flare
Files in alizharb/flare
Package flare
Short Description A beautiful, performant toast notification package for Laravel Livewire with real-time support
License MIT
Informations about the package flare
🎯 Overview
Flare is a modern, feature-rich toast notification system built specifically for Laravel Livewire applications. With zero configuration required and three distinct visual themes, Flare provides beautiful user feedback out of the box while offering extensive customization for advanced use cases.
✨ Features
| ### 🎨 **Three Professional Themes** - **Classic** - Minimal, clean, fastest performance - **Modern** - Balanced design with subtle effects _(default)_ - **Vibrant** - Bold, colorful, attention-grabbing All themes include: - ✓ Light & dark mode support - ✓ Smooth animations - ✓ Responsive design - ✓ RTL/LTR layouts ### ⚡ **High Performance** - Alpine.js powered (minimal overhead) - Optimized CSS transitions - Smart caching & compilation - No jQuery dependency - Lightweight footprint (~15KB) ### 🔧 **Developer Experience** - **Zero Configuration** - Works out of the box - **Simple API** - Intuitive, clean methods - **Livewire Trait** - `use WithFlare` - **TypeScript Support** - Full type definitions - **IDE Autocomplete** - PHPDoc annotations | ### 📍 **Flexible Positioning** - 6 position options (top/bottom × start/center/end) - Per-toast position override - RTL/LTR automatic adaptation - Responsive mobile behavior ### 🎭 **Advanced Features** - **Stacking System** - Configurable toast layering - **Auto-Dismiss** - Configurable duration - **Hover Pause** - Pause on mouse hover - **Keyboard Shortcuts** - Esc, Shift+Esc, Alt+D - **Progress Bar** - Visual countdown - **Queue Management** - Handle multiple toasts ### 🧪 **Production Ready** - ✓ Comprehensive test suite (12 tests, 22 assertions) - ✓ PHPStan Level 9 compliance - ✓ PSR-12 code style - ✓ CI/CD with GitHub Actions - ✓ Semantic versioning - ✓ Extensive documentation |
📋 Requirements
| Requirement | Version |
|---|---|
| PHP | 8.3+ |
| Laravel | 12.0+ / 13.0+ |
| Livewire | 3.5+ / 4.0+ |
| Alpine.js | 3.x / 4.x |
🚀 Installation
Step 1: Install via Composer
Step 2: Publish Assets
IMPORTANT: Assets must be published for Flare to work.
Step 3: Add to Layout
That's it! 🎉 You're ready to use Flare.
Optional Configuration
⚡ Quick Start
Using the Facade
Perfect for controllers, services, and any PHP class:
Using the Livewire Trait
The easiest way in Livewire components:
Using JavaScript
For client-side notifications:
🎨 Themes
Flare includes three professionally designed themes. Choose the one that fits your application's aesthetic.
| ### Classic **Minimal & Professional** Solid backgrounds Single shadow No blur ⚡ Fastest | ### Modern **Balanced & Contemporary** Subtle gradients Light blur (4px) 2 shadow layers ⚡ Fast _(default)_ | ### Vibrant **Bold & Colorful** Strong gradients Glowing shadows Moderate blur (8px) ⚡ Good |
All themes support light & dark modes automatically.
📚 Documentation
📖 Complete Documentation
Visit our comprehensive documentation:
- Introduction - What is Flare?
- Installation - Detailed setup guide
- Quick Start - Get started in 5 minutes
- Playground - Try it live
- Themes - Visual customization
- Configuration - All options explained
- Examples - Real-world scenarios
🌐 Interactive Docs
Run the documentation website locally:
Visit http://localhost:8000 for interactive documentation.
💡 API Reference
Toast Variants
Livewire Trait Methods
JavaScript API
⚙️ Configuration
View Complete Configuration
Environment Variables
🎯 Examples
Form Validation
CRUD Operations
Persistent Notifications
See EXAMPLES.md for more real-world scenarios.
⌨️ Keyboard Shortcuts
| Shortcut | Action |
|---|---|
Esc |
Dismiss most recent toast |
Shift + Esc |
Dismiss all toasts |
Alt + D |
Dismiss all toasts (alternative) |
🧪 Testing
Flare includes a comprehensive test suite:
Test Results: ✅ 12 tests, 22 assertions, 100% passing
🤝 Contributing
We welcome contributions! Please see CONTRIBUTING.md for details.
Development Setup
📝 Changelog
See CHANGELOG.md for all changes and version history.
Latest Release: v1.1.0
- ✨ Three distinct themes (Classic, Modern, Vibrant)
- 🐛 Fixed all positioning issues
- ⚡ Improved stacking performance
- 🌍 Added RTL/LTR support
- 📚 Complete documentation
📄 License
Flare is open-source software licensed under the MIT License.
🙏 Credits
Built with ❤️ by Ali Harb
Special thanks to:
- Laravel & Livewire teams
- Alpine.js community
- All contributors
🌟 Support
If you find Flare useful, please consider:
- ⭐ Starring the repository
- 🐛 Reporting bugs
- 💡 Suggesting features
- 📖 Improving documentation
- 💰 Sponsoring development
All versions of flare with dependencies
illuminate/support Version ^12.0 || ^13.0
livewire/livewire Version ^3.5 || ^4.0