PHPackages jeffersongoncalves/helpdeskkitv4 - 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/helpdeskkitv4 ActiveProject[Framework](/categories/framework) jeffersongoncalves/helpdeskkitv4 ================================ helpdeskkit starter kit built on Laravel 13.x and Filament 4.x with a ready-to-use multi-panel structure. 4.9.2(1mo ago)10MITPHPPHP ^8.3CI passing Since Mar 1Pushed 1mo ago1 watchersCompare [ Source](https://github.com/jeffersongoncalves/helpdeskkitv4)[ Packagist](https://packagist.org/packages/jeffersongoncalves/helpdeskkitv4)[ GitHub Sponsors](https://github.com/jeffersongoncalves)[ GitHub Sponsors](https://github.com/joaopaulolndev)[ RSS](/packages/jeffersongoncalves-helpdeskkitv4/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (3)Dependencies (42)Versions (7)Used By (0) [![HelpDeskKit v4](https://raw.githubusercontent.com/jeffersongoncalves/helpdeskkitv4/main/art/jeffersongoncalves-helpdeskkitv4.png)](https://raw.githubusercontent.com/jeffersongoncalves/helpdeskkitv4/main/art/jeffersongoncalves-helpdeskkitv4.png) HelpDesk Kit - Start Kit Filament 4.x and Laravel 13.x ====================================================== [](#helpdesk-kit---start-kit-filament-4x-and-laravel-13x) About HelpDesk Kit ------------------ [](#about-helpdesk-kit) HelpDesk Kit is a robust starter kit built on Laravel 13.x and Filament 4.x, designed to accelerate the development of help desk and support ticket systems 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 4.x** - Powerful and flexible admin framework - **Help Desk System** - Full-featured ticket management powered by `filament-help-desk` - Ticket creation, assignment, and tracking - Departments and categories - Canned responses - Email channel integration (inbound/outbound) - Ticket history and watchers - File attachments - **Multi-Panel Structure** - Includes four pre-configured panels: - **Admin Panel** (`/admin`) - Full system administration, user/operator management, help desk configuration - **Operator Panel** (`/operator`) - Dedicated panel for support operators to manage assigned tickets - **App Panel** (`/app`) - For authenticated users to create and track support tickets - **Guest Panel** (`/`) - Public frontend interface for visitors - **Multi-Guard Authentication** - Three separate auth guards with dedicated models: - `Admin` - Administrative access with impersonation support - `Operator` - Support operator access (ticket management only) - `User` - Application user access (ticket creation) - **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/helpdeskkitv4 --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/helpdeskkitv4 ``` > Install filakit CLI: `composer global require jeffersongoncalves/filakit-cli` ### Easy Installation [](#easy-installation) HelpDesk Kit 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/helpdeskkitv4 --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) HelpDesk Kit comes pre-configured with a multi-guard authentication system that supports three types of users: GuardModelPanelPathDescription`admin``Admin`Admin`/admin`Full system administration`operator``Operator`Operator`/operator`Support ticket management`web``User`App`/app`User-facing ticket creation### Default Credentials (after seeding) [](#default-credentials-after-seeding) RoleEmailPasswordAdmin`admin@helpdeskkit.com``password`Operator`operator@helpdeskkit.com``password`User`user@helpdeskkit.com``password`Help Desk System ---------------- [](#help-desk-system) HelpDesk Kit includes the `filament-help-desk` plugin, providing a complete support ticket system: ### Admin Panel (`/admin`) [](#admin-panel-admin) - Manage all tickets, departments, categories, and canned responses - Configure email channels for inbound/outbound ticket communication - Manage operators and assign them to departments - View ticket statistics and analytics widgets ### Operator Panel (`/operator`) [](#operator-panel-operator) - View and manage assigned tickets - Change ticket status and priority - Add comments and attachments - Bulk assign and status change operations - Ticket statistics by status widget ### App Panel (`/app`) [](#app-panel-app) - Create new support tickets - Track ticket status and history - View operator responses - Attach files to tickets 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` Alternatively, these settings are also consolidated in the `config/helpdeskkit.php` file for easier management. ### Panel Toggling [](#panel-toggling) Each panel can be enabled or disabled in `config/helpdeskkit.php`: ``` 'admin_panel_enabled' => true, 'operator_panel_enabled' => true, 'app_panel_enabled' => true, 'guest_panel_enabled' => true, ``` ### Themes and Colors [](#themes-and-colors) Each panel has its own color scheme: PanelColorTheme CSSAdminAmber`resources/css/filament/admin/theme.css`OperatorBlue`resources/css/filament/operator/theme.css`AppGreen`resources/css/filament/app/theme.css`Guest-`resources/css/filament/guest/theme.css`### Help Desk Configuration [](#help-desk-configuration) - `config/help-desk.php` - Core help desk settings (models, ticket settings, email, notifications) - `config/filament-help-desk.php` - Filament panel-specific settings (navigation, resources, slugs) ### 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 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, Operator, 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 - 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: Resources --------- [](#resources) HelpDesk Kit includes support for: - Help desk ticket management system - User, admin, and operator management - Multi-guard authentication system (3 guards) - Multi-panel Filament structure (4 panels) - Tailwind CSS integration - Database queue configuration - Customizable panel routing and branding - Email channel integration for ticket communication - Database notifications License ------- [](#license) This project is licensed under the [MIT License](LICENSE). Credits ------- [](#credits) Developed by [Jefferson Goncalves](https://github.com/jeffersongoncalves). ### Health Score 42 — FairBetter than 90% of packages Maintenance92 Actively maintained with recent releases Popularity2 Limited adoption so far Community14 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 43d ago PHP version history (2 changes)4.7.4PHP ^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] (143 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)")[![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)")[![josenetoz](https://avatars.githubusercontent.com/u/74790000?v=4)](https://github.com/josenetoz "josenetoz (1 commits)")[![andrefelipe18](https://avatars.githubusercontent.com/u/96439642?v=4)](https://github.com/andrefelipe18 "andrefelipe18 (1 commits)") --- Tags filamentfilament-4filament-pluginhelp-deskhelpdesklaravellaravel-12laravel-13multi-authmulti-paneloperator-panelphpstarter-kitsupport-systemtailwindcssticket-systemlaravellivewirefilamentstarter-kitlaravel-starter-kitfilament-starter-kittailwindcssfilament-v4 ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/jeffersongoncalves-helpdeskkitv4/health.svg) ``` [![Health](https://phpackages.com/badges/jeffersongoncalves-helpdeskkitv4/health.svg)](https://phpackages.com/packages/jeffersongoncalves-helpdeskkitv4) ``` ### 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)