arifbudimanar/zinc-ui

Zinc UI is a laravel blade component that work with livewire.

v0.1-alpha.91 2025-02-27 08:50 UTC

Requires

• php: ^8.4
• illuminate/contracts: ^10.0||^11.0||^12.0
• livewire/livewire: ^3.5
• masmerise/livewire-toaster: ^2.6
• spatie/laravel-package-tools: ^1.16

Requires (Dev)

• larastan/larastan: ^2.9
• laravel/pint: ^1.14
• nunomaduro/collision: ^8.1.1||^7.10.0
• orchestra/testbench: ^9.0.0||^8.22.0
• pestphp/pest: ^3.0
• pestphp/pest-plugin-arch: ^3.0
• pestphp/pest-plugin-laravel: ^3.0
• phpstan/extension-installer: ^1.3
• phpstan/phpstan-deprecation-rules: ^1.1
• phpstan/phpstan-phpunit: ^1.3

MIT

• Arif Budiman Arrosyid

• laravel
• tailwindcss
• livewire
• zinc-ui

README

Introduction

Zinc UI is A UI component library for Livewire , built with Tailwind CSS and Alpine.js.

Documentation

You can find the documentation here.

Installation

Package Status: Alpha Stage

Configure composer.json

Since Zinc UI is in its Alpha version, you need to modify the composer.json file. Open the file and ensure the following lines are present:

{
    "minimum-stability": "dev"
}

Install Zinc UI

Run the following command to add Zinc UI to your project:

composer require arifbudimanar/zinc-ui

Set up Zinc UI

After installation, initialize the package by running:

php artisan zinc:install

Check installed version

To check the version of Zinc UI installed, run:

php artisan zinc:version

Create a Livewire Component

Generate a Livewire component by running:

php artisan make:livewire Home

Update the Home.php file with this content:

#[Layout('layouts.sidebar-header')]
#[Title('Home')]
class Home extends Component
{
    public function render()
    {
        return view('livewire.home');
    }
}

Layout Options

Zinc UI includes several layouts tailored to different page types:

• header : For public pages like home and about.
• header-sidebar : For user-facing pages like dashboards and profiles.
• without-header : For authentication pages like login and register.
• sidebar : For admin pages like admin dashboards.
• sidebar-header : Another option for admin dashboards.

Update routes

Open the web.php file and define a route for your component:

use App\Livewire\Home;

Route::get('/', Home::class);

Run the application

Start the development server and compile the assets using:

composer run dev

Visit http://localhost:8000 to see Zinc UI in action.

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Arif Budiman Arrosyid
• All Contributors

License

The MIT License (MIT). Please see License File for more information.