PHPackages                             jeffersongoncalves/helpdeskkitv3 - 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. [Framework](/categories/framework)
4. /
5. jeffersongoncalves/helpdeskkitv3

ActiveProject[Framework](/categories/framework)

jeffersongoncalves/helpdeskkitv3
================================

helpdeskkit starter kit built on Laravel 12.x and Filament 3.x with a ready-to-use multi-panel structure.

3.3.49(2mo ago)10MITPHPPHP ^8.2CI passing

Since Mar 1Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/jeffersongoncalves/helpdeskkitv3)[ Packagist](https://packagist.org/packages/jeffersongoncalves/helpdeskkitv3)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ RSS](/packages/jeffersongoncalves-helpdeskkitv3/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (20)Versions (4)Used By (0)

[![Helpdesk Kit v3](https://raw.githubusercontent.com/jeffersongoncalves/helpdeskkitv3/main/art/jeffersongoncalves-helpdeskkitv3.png)](https://raw.githubusercontent.com/jeffersongoncalves/helpdeskkitv3/main/art/jeffersongoncalves-helpdeskkitv3.png)

HelpDeskKit — Starter Kit for Help Desk with Laravel 12 &amp; Filament 3
========================================================================

[](#helpdeskkit--starter-kit-for-help-desk-with-laravel-12--filament-3)

A production-ready starter kit for building help desk and customer support applications. Built on **Laravel 12**, **Filament 3**, **Livewire 3**, and **Tailwind CSS**, with multi-panel architecture and a complete ticketing system out of the box.

Features
--------

[](#features)

### Multi-Panel Architecture

[](#multi-panel-architecture)

Four pre-configured Filament panels, each with its own theme and authentication:

PanelURLPurpose**Admin**`/admin`System administration — manage admins, operators, and users**App**`/app`Authenticated users — create and track support tickets**Operator**`/operator`Support staff — manage tickets, departments, and responses**Guest**`/`Public-facing frontend for visitors### Help Desk System

[](#help-desk-system)

Complete ticketing system powered by [`filament-help-desk`](https://github.com/jeffersongoncalves/filament-help-desk):

- **Ticket Management** — Create, assign, update status and priority
- **Departments &amp; Categories** — Organize tickets by team and type
- **Comments &amp; Attachments** — Internal notes and file uploads
- **Canned Responses** — Pre-written reply templates
- **History Tracking** — Full audit trail of ticket changes
- **Watchers** — Follow tickets for updates
- **Email Integration** — Inbound email to ticket (IMAP, Mailgun, SendGrid, Resend, Postmark)
- **Notifications** — Email alerts on ticket events

### Multi-Guard Authentication

[](#multi-guard-authentication)

Three independent authentication guards with separate user models and database tables:

- `admin` — Admin model for system administrators
- `web` — User model for application users
- `operator` — Operator model for support staff

Each guard has its own login, registration, password reset, and email verification.

### User Features

[](#user-features)

- Profile management with avatar upload
- Browser session management
- API tokens via Laravel Sanctum
- In-app database notifications

### Developer Tools

[](#developer-tools)

- `composer dev` — Run server, queue, logs, and Vite in one command
- `composer ide-helper` — Generate IDE autocompletion files
- `composer pint` — Code style fixing with Laravel Pint
- `composer phpstan` — Static analysis with Larastan
- Developer logins for quick panel access during development
- Log viewer in the admin panel

Requirements
------------

[](#requirements)

- PHP 8.2+
- Composer
- Node.js with PNPM
- MySQL, PostgreSQL, or SQLite

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

[](#installation)

### Using Laravel Installer

[](#using-laravel-installer)

```
laravel new my-helpdesk --using=jeffersongoncalves/helpdeskkitv3 --database=mysql
```

### Using FilaKit CLI

[](#using-filakit-cli)

```
composer global require jeffersongoncalves/filakit-cli
filakit new my-helpdesk --kit=jeffersongoncalves/helpdeskkitv3
```

### Automated Setup

[](#automated-setup)

```
php install.php
```

This handles Composer dependencies, environment setup, key generation, database migrations, Node.js dependencies, and asset building.

### Manual Setup

[](#manual-setup)

```
composer install
pnpm install
cp .env.example .env
php artisan key:generate
php artisan migrate
```

Installation with Docker
------------------------

[](#installation-with-docker)

```
laravel new my-helpdesk --using=jeffersongoncalves/helpdeskkitv3 --database=mysql
cd my-helpdesk
composer install
cp .env.example .env
./vendor/bin/sail up -d
./vendor/bin/sail shell
php artisan key:generate
pnpm install
```

Configure custom ports in `.env` if needed:

```
APP_PORT=8080
FORWARD_DB_PORT=3306
FORWARD_REDIS_PORT=6379
FORWARD_MAILPIT_PORT=1025
```

Development
-----------

[](#development)

```
# Run all services (server, queue, logs, vite)
composer dev

# Or run individually
php artisan serve
php artisan queue:listen --tries=1
pnpm run dev
```

Customization
-------------

[](#customization)

### Panel Providers

[](#panel-providers)

Each panel is configured through its provider in `app/Providers/Filament/`:

- `AdminPanelProvider.php`
- `AppPanelProvider.php`
- `OperatorPanelProvider.php`
- `GuestPanelProvider.php`

### Configuration

[](#configuration)

The `config/helpdeskkit.php` file centralizes panel routes, middleware, branding, and authentication guards.

The `config/help-desk.php` file configures the ticketing system including email channels, notifications, attachments, and webhooks.

### Themes

[](#themes)

Each panel has its own Tailwind CSS theme in `resources/css/filament/`. Colors and styles can be customized per panel.

Tech Stack
----------

[](#tech-stack)

ComponentVersionLaravel12.xFilament3.xLivewire3.xTailwind CSS3.xVite7.xPest3.xLicense
-------

[](#license)

[MIT License](LICENSE)

Credits
-------

[](#credits)

Developed by [Jefferson Gonçalves](https://github.com/jeffersongoncalves).

###  Health Score

39

—

LowBetter than 86% of packages

Maintenance89

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor1

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

Unknown

Total

1

Last Release

72d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/411493?v=4)[Jefferson Gonçalves](/maintainers/jeffersongoncalves)[@jeffersongoncalves](https://github.com/jeffersongoncalves)

---

Top Contributors

[![jeffersongoncalves](https://avatars.githubusercontent.com/u/411493?v=4)](https://github.com/jeffersongoncalves "jeffersongoncalves (254 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (112 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (72 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (7 commits)")[![andrefelipe18](https://avatars.githubusercontent.com/u/96439642?v=4)](https://github.com/andrefelipe18 "andrefelipe18 (2 commits)")[![mmonari](https://avatars.githubusercontent.com/u/131320557?v=4)](https://github.com/mmonari "mmonari (2 commits)")[![achyutkneupane](https://avatars.githubusercontent.com/u/30431426?v=4)](https://github.com/achyutkneupane "achyutkneupane (2 commits)")[![josenetoz](https://avatars.githubusercontent.com/u/74790000?v=4)](https://github.com/josenetoz "josenetoz (1 commits)")

---

Tags

customer-supportfilamentfilament-starter-kitfilament-v3help-desklaravellaravel-12laravel-starter-kitlivewirelivewire-v3multi-authmulti-panelphpstarter-kittailwindcssticketing-systemlaravellivewirefilamentstarter-kitlaravel-starter-kitfilament-starter-kittailwindcssfilament-v3

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/jeffersongoncalves-helpdeskkitv3/health.svg)

```
[![Health](https://phpackages.com/badges/jeffersongoncalves-helpdeskkitv3/health.svg)](https://phpackages.com/packages/jeffersongoncalves-helpdeskkitv3)
```

###  Alternatives

[raugadh/fila-starter

Laravel Filament Starter.

614.9k](/packages/raugadh-fila-starter)[ercogx/laravel-filament-starter-kit

This is a Filament v3 Starter Kit for Laravel 12, designed to accelerate the development of Filament-powered applications.

401.5k](/packages/ercogx-laravel-filament-starter-kit)

PHPackages © 2026

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