PHPackages                             jeffersongoncalves/servicedeskkitv4 - 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/servicedeskkitv4

ActiveProject[Framework](/categories/framework)

jeffersongoncalves/servicedeskkitv4
===================================

ServiceDeskKit starter kit built on Laravel 13.x and Filament 4.x for service desk and helpdesk applications.

4.9.2(1mo ago)10MITPHPPHP ^8.3CI passing

Since Mar 1Pushed 1mo ago1 watchersCompare

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

READMEChangelog (3)Dependencies (38)Versions (7)Used By (0)

[![ServiceDeskKit v4](https://raw.githubusercontent.com/jeffersongoncalves/servicedeskkitv4/main/art/jeffersongoncalves-servicedeskkitv4.png)](https://raw.githubusercontent.com/jeffersongoncalves/servicedeskkitv4/main/art/jeffersongoncalves-servicedeskkitv4.png)

ServiceDeskKit Start Kit Filament 4.x and Laravel 13.x
======================================================

[](#servicedeskkit-start-kit-filament-4x-and-laravel-13x)

About ServiceDeskKit
--------------------

[](#about-servicedeskkit)

ServiceDeskKit is a robust starter kit built on Laravel 13.x and Filament 4.x, designed to accelerate the development of modern web applications with a ready-to-use multi-panel structure.

Features
--------

[](#features)

- **Laravel 13.x** - The latest version of the most elegant PHP framework
- **Filament 4.x** - Powerful and flexible admin framework
- **Multi-Panel Structure** - Includes four pre-configured panels:
    - Admin Panel (`/admin`) - For system administrators
    - Agent Panel (`/agent`) - For support operators/agents
    - App Panel (`/app`) - For authenticated application users
    - Guest Panel (`/`) - Public frontend interface for visitors
- **Environment Configuration** - Centralized configuration through the `config/servicedeskkit.php` file

System Requirements
-------------------

[](#system-requirements)

- PHP 8.3 or higher
- Composer
- Node.js and PNPM

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

[](#installation)

Clone the repository

```
laravel new my-app --using=jeffersongoncalves/servicedeskkitv4 --database=mysql
```

### Using FilaKit CLI

[](#using-filakit-cli)

Or use [FilaKit CLI](https://github.com/jeffersongoncalves/filakit-cli) for a simplified setup:

```
filakit new my-app --kit=jeffersongoncalves/servicedeskkitv4
```

> Install FilaKit CLI: `composer global require jeffersongoncalves/filakit-cli`

### Easy Installation

[](#easy-installation)

ServiceDeskKit can be easily installed using the following command:

```
php install.php
```

This command automates the installation process by:

- Installing Composer dependencies
- Setting up the environment file
- Generating application key
- Setting up the database
- Running migrations
- Installing Node.js dependencies
- Building assets
- Configuring Herd (if used)

### Manual Installation

[](#manual-installation)

Install JavaScript dependencies

```
pnpm install
```

Install Composer dependencies

```
composer install
```

Set up environment

```
cp .env.example .env
php artisan key:generate
```

Configure your database in the .env file

Run migrations

```
php artisan migrate
```

Run the server

```
php artisan serve
```

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

[](#installation-with-docker)

Clone the repository

```
laravel new my-app --using=jeffersongoncalves/servicedeskkitv4 --database=mysql
```

Move into the project directory

```
cd my-app
```

Install Composer dependencies

```
composer install
```

Set up environment

```
cp .env.example .env
```

Configuring custom ports may be necessary if you have other services running on the same ports.

```
# Application Port (ex: 8080)
APP_PORT=8080

# MySQL Port (ex: 3306)
FORWARD_DB_PORT=3306

# Redis Port (ex: 6379)
FORWARD_REDIS_PORT=6379

# Mailpit Port (ex: 1025)
FORWARD_MAILPIT_PORT=1025
```

Start the Sail containers

```
./vendor/bin/sail up -d
```

You won't need to run `php artisan serve`, as Laravel Sail automatically handles the development server within the container.

Attach to the application container

```
./vendor/bin/sail shell
```

Generate the application key

```
php artisan key:generate
```

Install JavaScript dependencies

```
pnpm install
```

Authentication Structure
------------------------

[](#authentication-structure)

ServiceDeskKit comes pre-configured with a custom authentication system that supports different types of users:

- `Admin` - For administrative panel access (`/admin`)
- `Operator` - For agent/support panel access (`/agent`)
- `User` - For application panel access (`/app`)

Each user type has its own database table, model, guard, and authentication flow. Default test credentials (after seeding):

User TypeEmailPasswordAdminpasswordOperatorpasswordUserpasswordDevelopment
-----------

[](#development)

```
# Run the development server with logs, queues and asset compilation
composer dev

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

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

[](#customization)

### Panel Configuration

[](#panel-configuration)

Panels can be customized through their respective providers:

- `app/Providers/Filament/AdminPanelProvider.php`
- `app/Providers/Filament/AgentPanelProvider.php`
- `app/Providers/Filament/AppPanelProvider.php`
- `app/Providers/Filament/GuestPanelProvider.php`

Alternatively, these settings are also consolidated in the `config/servicedeskkit.php` file for easier management.

### Themes and Colors

[](#themes-and-colors)

Each panel can have its own color scheme, which can be easily modified in the corresponding Provider files or in the `servicedeskkit.php` configuration file.

### Configuration File

[](#configuration-file)

The `config/servicedeskkit.php` file centralizes the configuration of the starter kit, including:

- Panel routes
- Middleware for each panel
- Branding options (logo, colors)
- Authentication guards

User Profile — joaopaulolndev/filament-edit-profile
---------------------------------------------------

[](#user-profile--joaopaulolndevfilament-edit-profile)

This project already comes with the Filament Edit Profile plugin integrated for the Admin and App panels. It adds a complete profile editing page with avatar, language, theme color, security (tokens, MFA), browser sessions, and email/password change.

- Routes (defaults in this project):
    - Admin: /admin/my-profile
    - App: /app/my-profile
- Navigation: by default, the page does not appear in the menu (shouldRegisterNavigation(false)). If you want to show it in the sidebar menu, change it to true in the panel provider.

Where to configure

- Panel providers

    - Admin: app/Providers/Filament/AdminPanelProvider.php
    - App: app/Providers/Filament/AppPanelProvider.php In these files you can adjust:
    - ->slug('my-profile') to change the URL (e.g., 'profile')
    - ->setTitle('My Profile') and ->setNavigationLabel('My Profile')
    - ->setNavigationGroup('Group Profile'), ->setIcon('heroicon-o-user'), ->setSort(10)
    - ->shouldRegisterNavigation(true|false) to show/hide it in the menu
    - Shown forms: ->shouldShowEmailForm(), ->shouldShowLocaleForm(\[...\]), ->shouldShowThemeColorForm(), ->shouldShowSanctumTokens(), ->shouldShowMultiFactorAuthentication(), ->shouldShowBrowserSessionsForm(), ->shouldShowAvatarForm()
- General settings: config/filament-edit-profile.php

    - locales: language options available on the profile page
    - locale\_column: column used in your model for language/locale (default: locale)
    - theme\_color\_column: column for theme color (default: theme\_color)
    - avatar\_column: avatar column (default: avatar\_url)
    - disk: storage disk used for the avatar (default: public)
    - visibility: file visibility (default: public)

Migrations and models

- The required columns are already included in this kit's default migrations (users and admins): avatar\_url, locale and theme\_color, using the names defined in config/filament-edit-profile.php.
- The App\\Models\\User and App\\Models\\Admin models already read the avatar using the plugin configuration (getFilamentAvatarUrl).

Avatar storage

- Make sure the filesystem disk is configured and that the storage link exists: php artisan storage:link
- Adjust the disk and visibility in the config file according to your infrastructure.

Quick access

- Via direct URL: /admin/my-profile or /app/my-profile
- To make it visible in the sidebar navigation, set shouldRegisterNavigation(true) in the respective Provider.

Reference

- Plugin repository:

Service Desk Plugin — filament-service-desk
-------------------------------------------

[](#service-desk-plugin--filament-service-desk)

ServiceDeskKit comes with the [filament-service-desk](https://github.com/jeffersongoncalves/filament-service-desk) plugin pre-installed, providing a complete helpdesk and support ticket system fully integrated into the Filament panels.

### Features

[](#features-1)

- **Ticket Management** — Create, assign, track, and resolve support tickets with comments, attachments, and full history
- **SLA Policies** — Define response and resolution time targets with automatic breach detection and escalation rules
- **Knowledge Base** — Publish articles organized by categories with versioning, feedback, and view tracking
- **Service Catalog** — Offer a catalog of services with custom form fields and approval workflows
- **Departments & Categories** — Organize tickets by department and category for better routing
- **Canned Responses** — Pre-defined response templates for common questions
- **Business Hours** — Configure work schedules that SLA calculations respect
- **Email Channels** — Receive tickets via email with support for IMAP, Mailgun, SendGrid, Resend, and Postmark
- **Tags** — Flexible tagging system for tickets

### Panel Integration

[](#panel-integration)

The plugin provides three specialized plugin classes, each designed for a specific panel:

PanelPlugin ClassFeaturesAdmin (`/admin`)`ServiceDeskPlugin`Full management: tickets, departments, categories, tags, SLA, knowledge base, service catalog, email channels, canned responses, business hours, escalation rulesAgent (`/agent`)`ServiceDeskAgentPlugin`Ticket handling: view assigned tickets, respond, use canned responses, manage SLAApp (`/app`)`ServiceDeskUserPlugin`User portal: create tickets, view own tickets, browse knowledge base, request services from catalog### Configuration Files

[](#configuration-files)

- **`config/filament-service-desk.php`** — Filament plugin settings (navigation, features toggle, resource/widget overrides)
- **`config/service-desk.php`** — Core settings (models, ticket options, SLA, knowledge base, service catalog, email, notifications)

### Key Settings in `config/service-desk.php`

[](#key-settings-in-configservice-deskphp)

```
'models' => [
    'user' => \App\Models\User::class,      // Model that creates tickets
    'operator' => \App\Models\Operator::class, // Model that handles tickets
],

'ticket' => [
    'reference_prefix' => 'SD',       // Ticket reference prefix (e.g., SD-00001)
    'default_priority' => 'medium',    // Default priority for new tickets
    'max_file_size' => 10240,          // Max attachment size in KB
],

'sla' => [
    'enabled' => true,
    'auto_apply' => true,              // Automatically apply SLA policies
    'near_breach_minutes' => 30,       // Warning before SLA breach
],
```

### Required Model Traits

[](#required-model-traits)

The following traits must be added to your models (already configured in this kit):

- **`App\Models\User`** — Uses `JeffersonGoncalves\ServiceDesk\Concerns\HasTickets` (allows users to create and manage their tickets)
- **`App\Models\Operator`** — Uses `JeffersonGoncalves\ServiceDesk\Concerns\IsOperator` (enables operator functionality: ticket assignment, department membership, etc.)

### Customization

[](#customization-1)

You can override any resource or widget by specifying your custom class in `config/filament-service-desk.php`:

```
'resources' => [
    'admin' => [
        'ticket' => \App\Filament\Admin\Resources\CustomTicketResource::class,
        // ...
    ],
],
```

Toggle features per-panel using fluent methods on the plugin:

```
ServiceDeskPlugin::make()
    ->knowledgeBase(true)
    ->sla(true)
    ->emailChannels(true)
    ->serviceCatalog(true)
    ->navigationGroup('Service Desk'),
```

### Reference

[](#reference)

- Plugin repository:
- Core package:

Resources
---------

[](#resources)

ServiceDeskKit includes support for:

- User, operator, and admin management
- Multi-guard authentication system (admin, operator, web)
- Integrated helpdesk with tickets, SLA, knowledge base, and service catalog
- Tailwind CSS integration
- Database queue configuration
- Customizable panel routing and branding

License
-------

[](#license)

This project is licensed under the [MIT License](LICENSE).

Credits
-------

[](#credits)

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

###  Health Score

42

—

FairBetter than 90% of packages

Maintenance92

Actively maintained with recent releases

Popularity2

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 62.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 ~14 days

Total

3

Last Release

44d ago

PHP version history (2 changes)4.8.0PHP ^8.2

4.9.0PHP ^8.3

### 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 (427 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (141 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (102 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (7 commits)")[![achyutkneupane](https://avatars.githubusercontent.com/u/30431426?v=4)](https://github.com/achyutkneupane "achyutkneupane (2 commits)")[![mmonari](https://avatars.githubusercontent.com/u/131320557?v=4)](https://github.com/mmonari "mmonari (2 commits)")[![zdearo](https://avatars.githubusercontent.com/u/110416695?v=4)](https://github.com/zdearo "zdearo (1 commits)")[![andrefelipe18](https://avatars.githubusercontent.com/u/96439642?v=4)](https://github.com/andrefelipe18 "andrefelipe18 (1 commits)")[![josenetoz](https://avatars.githubusercontent.com/u/74790000?v=4)](https://github.com/josenetoz "josenetoz (1 commits)")

---

Tags

filamentfilament-starter-kitfilament-v4helpdesklaravellaravel-13laravel-starter-kitlivewirelivewire-v3multi-authmulti-panelphpservice-deskstarter-kittailwindcsslaravellivewirefilamentstarter-kitlaravel-starter-kitfilament-starter-kittailwindcssfilament-v4service-deskhelpdesk

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

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

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

###  Alternatives

[raugadh/fila-starter

Laravel Filament Starter.

614.9k](/packages/raugadh-fila-starter)[riodwanto/superduper-filament-starter-kit

A comprehensive Laravel Filament 3 💡 starter kit with pre-installed plugins, admin panel, user management, SEO tools, theme customization, and content management for rapid application development

2708.5k](/packages/riodwanto-superduper-filament-starter-kit)[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)