PHPackages                             iquesters/user-interface - 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. [Templating & Views](/categories/templating)
4. /
5. iquesters/user-interface

ActiveLibrary[Templating & Views](/categories/templating)

iquesters/user-interface
========================

A modern, reusable, and customizable UI interface built for creating clean and responsive user experiences. Designed with simplicity, scalability, and flexibility in mind.

v1.0.31(1mo ago)01201[3 issues](https://github.com/iquesters/user-interface/issues)[2 PRs](https://github.com/iquesters/user-interface/pulls)MITJavaScriptPHP >=8.1CI passing

Since Sep 29Pushed 1mo agoCompare

[ Source](https://github.com/iquesters/user-interface)[ Packagist](https://packagist.org/packages/iquesters/user-interface)[ RSS](/packages/iquesters-user-interface/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (6)Versions (30)Used By (0)

Laravel User Interface Package – Iquesters [![Iquesters Logo](https://avatars.githubusercontent.com/u/7593318?s=200&v=4)](https://avatars.githubusercontent.com/u/7593318?s=200&v=4)
====================================================================================================================================================================================

[](#laravel-user-interface-package--iquesters-)

A modern, reusable, and customizable **UI package** for Laravel applications — developed and maintained by **[Iquesters](https://github.com/iquesters)**.

This package provides a unified **layout structure**, **navigation system**, and **interface configuration** for Laravel-based modular applications. It acts as the **front-end foundation** for many Iquesters packages, ensuring a consistent, clean, and responsive user interface.

---

⚙️ Purpose
----------

[](#️-purpose)

The **User Interface Package** serves as the **visual and layout layer** for Iquesters modules. It includes ready-to-use templates such as headers, sidebars, module tabs, and dropdowns — all styled for scalability and responsiveness.

It allows developers to:

- Maintain consistent design across all Iquesters modules
- Configure layouts and navigation behavior easily
- Integrate seamlessly with other Iquesters packages

---

🚀 Installation
--------------

[](#-installation)

1. **Install the package via Composer**

    ```
    composer require iquesters/user-interface
    ```
2. **Run the migrations**

    ```
    php artisan migrate
    ```
3. **Seed the default UI data**

    ```
    php artisan user-interface:seed
    ```

Once installed, the package automatically registers its layout and configuration.

---

🎨 Features
----------

[](#-features)

- 🧱 **Unified Layout System** — Shared structure for headers, sidebars, and navigation
- ⚙️ **Configurable via .env** — Customize UI behavior without touching code
- 📱 **Responsive Design** — Optimized for both desktop and mobile
- 🔄 **Dynamic Module Tabs** — Automatically handles module navigation
- 🧩 **Integration-Ready** — Works seamlessly with other Iquesters modules

---

🔧 How to Configure
------------------

[](#-how-to-configure)

The package includes a config file located at `config/userinterface.php`. You can override any setting using your `.env` file.

### 1. Middleware

[](#1-middleware)

Defines which middleware are applied to your application layout.

```
USERINTERFACE_MIDDLEWARE="web,auth"
```

*Default:* `['web', 'auth']`

---

### 2. Layout Template

[](#2-layout-template)

Specifies the default Blade layout used as your app’s shell.

```
USERINTERFACE_LAYOUT_APP="userinterface::layouts.app"
```

You can change this if you have your own layout file.

---

### 3. Logo Configuration

[](#3-logo-configuration)

Set your brand logo (URL or path).

```
USER_MANAGEMENT_LOGO="/images/logo.png"
```

You can use:

- A full URL (e.g., `https://example.com/logo.png`)
- A local path (e.g., `/images/logo.png`)
- A package asset path (e.g., `img/logo.png`)

---

### 4. Navigation Style

[](#4-navigation-style)

Choose your preferred navigation style.

```
USERINTERFACE_NAV_STYLE=minibar
```

Options:

- `minibar` — vertical left sidebar
- `header` — horizontal module tabs in header

---

### 5. Module Tabs

[](#5-module-tabs)

Set how many modules appear before the rest go into a dropdown.

```
USERINTERFACE_MODULE_TABS=7
```

---

### 6. Mobile Navigation

[](#6-mobile-navigation)

Configure how the mobile bottom navigation behaves.

```
USERINTERFACE_MOBILE_BOTTOM_TABS=4
USERINTERFACE_MOBILE_FEATURED_TAB=null
USERINTERFACE_MOBILE_FEATURED_POSITION=center
```

- `USERINTERFACE_MOBILE_FEATURED_TAB`: Set a featured module (e.g., `dashboard`)
- `USERINTERFACE_MOBILE_FEATURED_POSITION`: `center`, `left`, or `right`

---

###  Health Score

45

—

FairBetter than 93% of packages

Maintenance90

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 Bus Factor1

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

###  Release Activity

Cadence

Every ~6 days

Total

28

Last Release

49d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f4dcd42249f784c4fa056815878ce2ea00bd0deb31b0d1858a73e02a82831156?d=identicon)[pritam](/maintainers/pritam)

---

Top Contributors

[![PritamBag](https://avatars.githubusercontent.com/u/130136389?v=4)](https://github.com/PritamBag "PritamBag (132 commits)")[![sudipta-2022](https://avatars.githubusercontent.com/u/129753484?v=4)](https://github.com/sudipta-2022 "sudipta-2022 (64 commits)")[![anantakumarghosh](https://avatars.githubusercontent.com/u/61864488?v=4)](https://github.com/anantakumarghosh "anantakumarghosh (2 commits)")

### Embed Badge

![Health badge](/badges/iquesters-user-interface/health.svg)

```
[![Health](https://phpackages.com/badges/iquesters-user-interface/health.svg)](https://phpackages.com/packages/iquesters-user-interface)
```

###  Alternatives

[cagilo/cagilo

A set of open-source Blade components for the Laravel Framework

172996.5k](/packages/cagilo-cagilo)[orchid/blade-icons

An easy way inline SVG images in your Blade templates.

223.4M9](/packages/orchid-blade-icons)[wireui/heroicons

The Tailwind Heroicons for laravel blade by WireUI

43390.8k5](/packages/wireui-heroicons)[stillat/antlers-components

2656.0k1](/packages/stillat-antlers-components)[itstructure/laravel-grid-view

Grid view for laravel framework

2546.6k2](/packages/itstructure-laravel-grid-view)[ycs77/inertia-laravel-ssr-head

Simple SSR Head for Inertia Laravel

3211.5k](/packages/ycs77-inertia-laravel-ssr-head)

PHPackages © 2026

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