PHPackages                             codenzia/project-essentials - 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. [Utility &amp; Helpers](/categories/utility)
4. /
5. codenzia/project-essentials

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

codenzia/project-essentials
===========================

Essential project utilities and helpers for Laravel applications.

00[2 PRs](https://github.com/Codenzia/project-essentials/pulls)PHPCI passing

Since Feb 28Pushed 1mo agoCompare

[ Source](https://github.com/Codenzia/project-essentials)[ Packagist](https://packagist.org/packages/codenzia/project-essentials)[ RSS](/packages/codenzia-project-essentials/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (3)Used By (0)

Project Essentials
==================

[](#project-essentials)

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

Features
--------

[](#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
------------

[](#requirements)

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

Installation
------------

[](#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
----------

[](#components)

### Progress

[](#progress)

A circular progress indicator with SVG arc and gradient colors.

```

```

PropTypeDefaultDescription`progress`float`0`Progress percentage (0-100)`color`string`'primary'`CSS color variable name`label`string`'Progress'`Display label`showText`bool`true`Show percentage text### Carousel (Blade)

[](#carousel-blade)

A simple Swiper.js carousel for Blade templates.

```

```

PropTypeDefaultDescription`slides`array`[]`Array of slide content`autoplay`bool`false`Enable autoplay`indicators`bool`true`Show pagination dots`controls`bool`true`Show prev/next arrows### CarouselEntry (Filament Infolist)

[](#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:**

MethodDescription`slidesPerView(int)`Number of visible slides`centeredSlides(bool)`Center active slide`height(int)`Container height in pixels`navigation(bool)`Show prev/next arrows`pagination(bool)`Show pagination`paginationType(string)``'bullets'`, `'fraction'`, `'progressbar'``paginationClickable(bool)`Clickable pagination bullets`scrollbar(bool)`Show scrollbar`autoplay(bool)`Enable autoplay`autoplayDelay(int)`Autoplay delay in ms`effect(string)``'slide'`, `'fade'`, `'cube'`, `'coverflow'`, `'flip'`, `'cards'``cardSchema(Closure)`Dynamic schema builder for each slide### Pagination

[](#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)

[](#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
-------------------

[](#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
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

21

—

LowBetter than 18% of packages

Maintenance59

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity15

Early-stage or recently created project

 Bus Factor1

Top contributor holds 55% 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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/7c09a47187ca823dff0650b985b6b1d0632bf550fffbd692005cb12ffae5e8ac?d=identicon)[mh2x](/maintainers/mh2x)

---

Top Contributors

[![sehsah](https://avatars.githubusercontent.com/u/8730764?v=4)](https://github.com/sehsah "sehsah (11 commits)")[![mh2x](https://avatars.githubusercontent.com/u/10361843?v=4)](https://github.com/mh2x "mh2x (7 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)")

### Embed Badge

![Health badge](/badges/codenzia-project-essentials/health.svg)

```
[![Health](https://phpackages.com/badges/codenzia-project-essentials/health.svg)](https://phpackages.com/packages/codenzia-project-essentials)
```

###  Alternatives

[froala/wysiwyg-editor

A beautiful jQuery WYSIWYG HTML rich text editor. High performance and modern design make it easy to use for developers and loved by users.

5.4k306.9k3](/packages/froala-wysiwyg-editor)[rewieer/taskschedulerbundle

Task Scheduler with CRON for Symfony

63242.1k](/packages/rewieer-taskschedulerbundle)[ghoster/module-outofstockatlast

Magento 2.4.x module Sort Out Of Stock Product At last the product list

60122.6k](/packages/ghoster-module-outofstockatlast)[fof/byobu

Well integrated, advanced private discussions.

61105.8k9](/packages/fof-byobu)[flowpack/listable

Tiny extension for listing things

35209.0k7](/packages/flowpack-listable)[snowdog/module-alpaca-components

Components of the Alpaca theme for Magento 2

4582.2k2](/packages/snowdog-module-alpaca-components)

PHPackages © 2026

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