README

Essential UI components, form components, and utilities for Laravel and Filament v4 projects — including progress indicators, carousels, pagination, and an icon picker.

Features

• Progress Component — Circular SVG progress indicator with gradient colors
• Carousel Component — Swiper.js-powered carousel for Blade templates
• CarouselEntry — Filament infolist entry with dynamic card schemas and full Swiper configuration
• Pagination — Custom Laravel pagination view with RTL and dark mode support
• IconPicker — Filament form select with 45+ categorized Heroicons
• Dark Mode — All components support dark mode
• RTL Support — Right-to-left layout support

Requirements

• PHP 8.3+
• Laravel 12+
• Filament 4.x

Installation

Install via Composer:

composer require codenzia/project-essentials

Publish the config (optional):

php artisan vendor:publish --tag="project-essentials-config"

Publish views for customization (optional):

php artisan vendor:publish --tag="project-essentials-views"

Components

Progress

A circular progress indicator with SVG arc and gradient colors.

<x-project-essentials::progress
    :progress="75"
    color="primary"
    label="Completion"
    :show-text="true"
/>

Carousel (Blade)

A simple Swiper.js carousel for Blade templates.

<x-project-essentials::carousel
    :slides="$slides"
    :autoplay="true"
    :indicators="true"
    :controls="true"
/>

CarouselEntry (Filament Infolist)

An advanced carousel component for Filament infolists with dynamic card schemas.

use Codenzia\ProjectEssentials\View\Components\CarouselEntry;

CarouselEntry::make('items')
    ->slidesPerView(3)
    ->navigation()
    ->pagination()
    ->autoplay()
    ->autoplayDelay(3000)
    ->effect('slide')
    ->height(300)
    ->cardSchema(function (Schema $schema, ?Model $record) {
        return $schema->components([
            TextEntry::make('title'),
            TextEntry::make('description'),
            ImageEntry::make('image'),
        ]);
    })

Available methods:

Pagination

A custom pagination view with mobile-friendly layout, RTL support, and dark mode.

{{ $items->links('project-essentials::components.pagination') }}

Features:

• Mobile: simplified prev/next with result count
• Desktop: full page numbers with prev/next
• Active page highlighted with brand color
• RTL-aware layout

IconPicker (Form Component)

A searchable Filament select field pre-loaded with 45+ categorized Heroicons.

use Codenzia\ProjectEssentials\Forms\Components\IconPicker;

IconPicker::make('icon')
    ->label('Icon')
    ->required()

Categories include: Education, Buildings, Location, Transport, Health, Shopping, Communication, Nature, Utilities, Recreation, People, and more.

Returns the icon string value (e.g., 'heroicon-o-home').

Plugin Registration

Register the plugin in your Filament panel provider:

use Codenzia\ProjectEssentials\ProjectEssentialsPlugin;

public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            ProjectEssentialsPlugin::make(),
        ]);
}

License

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