PHPackages jeffersongoncalves/helpdeskkitv5 - 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/helpdeskkitv5 ActiveProject[Framework](/categories/framework) jeffersongoncalves/helpdeskkitv5 ================================ helpdeskkit starter kit built on Laravel 13.x and Filament 5.x with a ready-to-use multi-panel structure. 5.4.4(1mo ago)13MITPHPPHP ^8.3CI passing Since Mar 1Pushed 1mo ago1 watchersCompare [ Source](https://github.com/jeffersongoncalves/helpdeskkitv5)[ Packagist](https://packagist.org/packages/jeffersongoncalves/helpdeskkitv5)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ RSS](/packages/jeffersongoncalves-helpdeskkitv5/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (40)Versions (13)Used By (0) [![HelpDeskKit v5](https://raw.githubusercontent.com/jeffersongoncalves/helpdeskkitv5/main/art/jeffersongoncalves-helpdeskkitv5.png)](https://raw.githubusercontent.com/jeffersongoncalves/helpdeskkitv5/main/art/jeffersongoncalves-helpdeskkitv5.png) HelpDeskKit — Start Kit Filament 5.x and Laravel 13.x ===================================================== [](#helpdeskkit--start-kit-filament-5x-and-laravel-13x) About HelpDeskKit ----------------- [](#about-helpdeskkit) HelpDeskKit is a robust starter kit built on Laravel 13.x and Filament 5.x, designed to accelerate the development of help desk and support ticket applications with a ready-to-use multi-panel structure and integrated ticket management. Features -------- [](#features) - **Laravel 13.x** — The latest version of the most elegant PHP framework - **Filament 5.x** — Powerful and flexible admin framework - **Help Desk System** — Full ticket management powered by [filament-help-desk](https://github.com/jeffersongoncalves/filament-help-desk) - Ticket creation, assignment, comments, attachments, and history - Departments, categories, canned responses, and email channels - Priority and status workflows with bulk actions - **Multi-Panel Structure** — Includes four pre-configured panels: - Admin Panel (`/admin`) — System administration and help desk oversight - Operator Panel (`/operator`) — Support agents managing tickets - App Panel (`/app`) — End users creating and tracking tickets - Guest Panel — Public-facing interface for visitors - **Multi-Auth Guard** — Three independent authentication guards: - `admin` — Admin model with full system access - `operator` — Operator model for support agents - `web` — User model for application users - **Environment Configuration** — Centralized configuration through the `config/helpdeskkit.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/helpdeskkitv5 --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/helpdeskkitv5 ``` > Install FilaKit CLI: `composer global require jeffersongoncalves/filakit-cli` ### Easy Installation [](#easy-installation) helpdeskkit 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/helpdeskkitv5 --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) HelpDeskKit comes pre-configured with a multi-guard authentication system that supports three types of users: - `Admin` — Full administrative access, help desk oversight, user/operator management (`/admin`) - `Operator` — Support agent access, ticket management and assignment (`/operator`) - `User` — End-user access, ticket creation and tracking (`/app`) Each guard uses its own database table, model, login page, and password reset flow. Development ----------- [](#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/OperatorPanelProvider.php` - `app/Providers/Filament/AppPanelProvider.php` - `app/Providers/Filament/GuestPanelProvider.php` Each panel can be enabled or disabled in `config/helpdeskkit.php`. ### 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 `helpdeskkit.php` configuration file. ### Configuration File [](#configuration-file) The `config/helpdeskkit.php` file centralizes the configuration of the starter kit, including: - Panel routes - Middleware for each panel - Branding options (logo, colors) - Authentication guards Help Desk — jeffersongoncalves/filament-help-desk ------------------------------------------------- [](#help-desk--jeffersongoncalvesfilament-help-desk) HelpDeskKit includes a full-featured help desk system powered by [filament-help-desk](https://github.com/jeffersongoncalves/filament-help-desk): - **User Panel (`/app/tickets`)** — End users create tickets, track status, and view responses - **Operator Panel (`/operator/tickets`)** — Support agents manage assigned tickets, change status/priority, add comments - **Admin Panel (`/admin/tickets`)** — Administrators oversee all tickets, departments, categories, and settings ### Help Desk Features [](#help-desk-features) - Ticket creation with departments and categories - Ticket assignment to operators - Comments and attachments - Status and priority workflows - Ticket history and audit trail - Canned responses - Email channel integration (Mailgun, Postmark, Resend, SendGrid) - Bulk actions (assign, change status, change priority) ### Configuration [](#configuration) - `config/help-desk.php` — Core help desk settings (models, tables, features) - `config/filament-help-desk.php` — Filament UI settings (navigation, slugs, icons) User Profile — joaopaulolndev/filament-edit-profile --------------------------------------------------- [](#user-profile--joaopaulolndevfilament-edit-profile) This project comes with the Filament Edit Profile plugin integrated for all panels (Admin, Operator, and App). 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 - Operator: /operator/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 - Operator: app/Providers/Filament/OperatorPanelProvider.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, admins, and operators): avatar\_url, locale and theme\_color, using the names defined in config/filament-edit-profile.php. - The App\\Models\\User, App\\Models\\Admin, and App\\Models\\Operator 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, /operator/my-profile, or /app/my-profile - To make it visible in the sidebar navigation, set shouldRegisterNavigation(true) in the respective Provider. Reference - Plugin repository: Default Credentials ------------------- [](#default-credentials) After running `php artisan db:seed`, use these credentials: PanelURLEmailPasswordAdmin`/admin``admin@helpdeskkit.com``password`Operator`/operator``operator@helpdeskkit.com``password`App`/app``user@helpdeskkit.com``password`Resources --------- [](#resources) HelpDeskKit includes support for: - User, admin, and operator management - Multi-guard authentication system (3 guards) - Help desk ticket system with full lifecycle management - Tailwind CSS 4.x 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 44 — FairBetter than 92% of packages Maintenance92 Actively maintained with recent releases Popularity6 Limited adoption so far Community15 Small or concentrated contributor base Maturity56 Maturing project, gaining track record Bus Factor1 Top contributor holds 62.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 Every ~3 days Total 10 Last Release 39d ago PHP version history (2 changes)5.2.4PHP ^8.2 5.4.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 (443 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (154 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (101 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-5filamentphphelp-deskhelpdesklaravellaravel-12laravel-13laravel-starter-kitlivewiremulti-authmulti-panelphpstarter-kitsupport-tickettailwindcssticket-systemlaravellivewirefilamentstarter-kitlaravel-starter-kitfilament-starter-kittailwindcssfilament-v5 ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/jeffersongoncalves-helpdeskkitv5/health.svg) ``` [![Health](https://phpackages.com/badges/jeffersongoncalves-helpdeskkitv5/health.svg)](https://phpackages.com/packages/jeffersongoncalves-helpdeskkitv5) ``` ### 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)