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.36(2w ago)01442[7 issues](https://github.com/iquesters/user-interface/issues)[3 PRs](https://github.com/iquesters/user-interface/pulls)MITJavaScriptPHP >=8.1CI passing

Since Sep 29Pushed 1w 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 today

READMEChangelogDependencies (12)Versions (42)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

48

—

FairBetter than 93% of packages

Maintenance97

Actively maintained with recent releases

Popularity14

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 68.4% 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 ~8 days

Recently: every ~17 days

Total

33

Last Release

17d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/87039?v=4)[pritam](/maintainers/pritam)[@pritam](https://github.com/pritam)

---

Top Contributors

[![PritamBag](https://avatars.githubusercontent.com/u/130136389?v=4)](https://github.com/PritamBag "PritamBag (154 commits)")[![sudipta-2022](https://avatars.githubusercontent.com/u/129753484?v=4)](https://github.com/sudipta-2022 "sudipta-2022 (64 commits)")[![glitched-matrix44](https://avatars.githubusercontent.com/u/255717373?v=4)](https://github.com/glitched-matrix44 "glitched-matrix44 (4 commits)")[![anantakumarghosh](https://avatars.githubusercontent.com/u/61864488?v=4)](https://github.com/anantakumarghosh "anantakumarghosh (2 commits)")[![snehaaa162](https://avatars.githubusercontent.com/u/204314375?v=4)](https://github.com/snehaaa162 "snehaaa162 (1 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

[unopim/unopim

UnoPim Laravel PIM

10.5k2.4k](/packages/unopim-unopim)[bagisto/bagisto

Bagisto Laravel E-Commerce

27.6k172.1k9](/packages/bagisto-bagisto)[grumpydictator/firefly-iii

Firefly III: a personal finances manager.

23.9k69.5k](/packages/grumpydictator-firefly-iii)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135224.7k7](/packages/statamic-rad-pack-runway)[api-platform/laravel

API Platform support for Laravel

58171.6k14](/packages/api-platform-laravel)[duncanmcclean/statamic-cargo

Comprehensive e-commerce addon for Statamic. Build bespoke e-commerce sites without the complexity.

3417.0k](/packages/duncanmcclean-statamic-cargo)

PHPackages © 2026

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