Skip to content

Material Blade is a simple package that provides the beautifulness of Google Material Design components as Laravel Blade components. Material Blade aims to make UI/UX development of your Laravel app faster, inspired by Material UI.

License

Notifications You must be signed in to change notification settings

dominosaurs/material-blade

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🎨 Material Blade

Beautiful Google Material Design components for Laravel Blade ✨

Transform your Laravel applications with elegant, ready-to-use Material Design components. Build stunning UIs faster than ever, inspired by Material UI πŸš€

License Laravel PHP


⚑ Why Material Blade?

Before πŸ˜“

<button class="mdc-button mdc-button--raised">
    <span class="mdc-button__ripple"></span>
    <span class="mdc-button__label">Click Me</span>
</button>

After 😎

<x-mbc::button label="Click Me" variant="raised" />

Simple. Clean. Beautiful. That's Material Blade! πŸ’«


πŸš€ Quick Start

πŸ“¦ Installation

composer require sensasi-delight/material-blade

🎯 Setup

Add the assets component in your layout's <head>:

<!doctype html>
<html lang="en">
    <head>
        <meta charset="UTF-8" />
        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
        <title>My App</title>

        <!-- 🎨 Material Blade Assets -->
        <x-mbc::_assets />
    </head>
    <body>
        <!-- ✨ Start using components! -->
        <x-mbc::button label="Hello World" color="primary" />
    </body>
</html>

πŸ’‘ Usage Examples

{{-- 🎯 Alerts --}}
<x-mbc::alert severity="success">Profile updated successfully!</x-mbc::alert>

{{-- 🎨 Cards --}}
<x-mbc::card>
    <x-mbc::card-header title="Welcome" subtitle="Material Blade" />
    <x-mbc::card-content>
        Build beautiful interfaces with Material Design!
    </x-mbc::card-content>
</x-mbc::card>

{{-- πŸ”˜ Buttons --}}
<x-mbc::button variant="raised" color="primary" icon="save">
    Save Changes
</x-mbc::button>

{{-- πŸ“ Text Fields --}}
<x-mbc::text-field label="Email" type="email" required />

πŸ“š Components

30+ Material Design components ready to use:

🎯 Feedback & Alerts

🧭 Navigation

πŸŽ›οΈ Input & Forms

πŸ“Š Data Display

⏳ Progress Indicators

πŸ“– View Full Documentation β†’


✨ Features

  • βœ… 30+ Components - Complete Material Design component library
  • βœ… Type-Safe - PHP enums for variants and properties
  • βœ… Theme Support - Built-in color system with CSS variables
  • βœ… Auto-Discovery - No manual service provider registration (Laravel 8+)
  • βœ… Icon Variants - Filled, Outlined, Round, Sharp, Two-Tone
  • βœ… Elevation Support - Material Design elevation levels (0-24)
  • βœ… Slot-Based - Flexible content structure with Blade slots
  • βœ… Well Documented - Comprehensive docs and examples

πŸ› οΈ Development

Want to contribute? We'd love your help! πŸ’ͺ

# Clone the repository
git clone https://github.com/sensasi-delight/material-blade
cd material-blade

# Install dependencies
composer install
npm install

# Start development
npm run dev

🀝 Contributing

  1. 🍴 Fork the Project
  2. 🌿 Create your Feature Branch (git checkout -b feature/AmazingFeature)
  3. πŸ’Ύ Commit your Changes (git commit -m 'Add some AmazingFeature')
  4. πŸ“€ Push to the Branch (git push origin feature/AmazingFeature)
  5. πŸŽ‰ Open a Pull Request

All contributions are greatly appreciated! ❀️


πŸ“‹ Requirements

  • 🐘 PHP 8.1 or higher
  • 🎨 Laravel 9.x, 10.x, 11.x, or 12.x
  • πŸ’‘ Basic knowledge of Blade Components

πŸŽ“ Resources


πŸ“„ License

Released under the MIT License. Free to use in personal and commercial projects! πŸŽ‰


🌟 Star us on GitHub!

If you find Material Blade useful, please give us a star ⭐

Made with ❀️ for the Laravel community

⬆ Back to top

About

Material Blade is a simple package that provides the beautifulness of Google Material Design components as Laravel Blade components. Material Blade aims to make UI/UX development of your Laravel app faster, inspired by Material UI.

Topics

Resources

License

Stars

Watchers

Forks