jeffersongoncalves / helpdeskkitv4
helpdeskkit starter kit built on Laravel 12.x and Filament 4.x with a ready-to-use multi-panel structure.
Maintainers
Package info
github.com/jeffersongoncalves/helpdeskkitv4
Type:project
pkg:composer/jeffersongoncalves/helpdeskkitv4
Requires
- php: ^8.2
- achyutn/filament-log-viewer: ^1.2
- dutchcodingcompany/filament-developer-logins: ^2.1
- filament/filament: ^4.5
- jeffersongoncalves/filament-help-desk: 2.0
- jeffersongoncalves/filament-logo: ^2.0
- joaopaulolndev/filament-edit-profile: ^2.0
- laravel/framework: ^12.0
- laravel/tinker: ^2.10.1
- livewire/livewire: ^3.7
- wallacemartinss/filament-icon-picker: ^1.2
Requires (Dev)
- barryvdh/laravel-debugbar: ^4.0
- barryvdh/laravel-ide-helper: ^3.5
- fakerphp/faker: ^1.23
- larastan/larastan: ^3.2
- laravel/pail: ^1.1
- laravel/pint: ^1.13
- laravel/sail: ^1.26
- mockery/mockery: ^1.6
- nunomaduro/collision: ^8.1
- pestphp/pest: ^3.7
- pestphp/pest-plugin-laravel: ^3.0
README
HelpDesk Kit - Start Kit Filament 4.x and Laravel 12.x
About HelpDesk Kit
HelpDesk Kit is a robust starter kit built on Laravel 12.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
- Laravel 12.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
- Admin Panel (
- Multi-Guard Authentication - Three separate auth guards with dedicated models:
Admin- Administrative access with impersonation supportOperator- Support operator access (ticket management only)User- Application user access (ticket creation)
- Environment Configuration - Centralized configuration through the
config/helpdeskkit.phpfile
System Requirements
- PHP 8.2 or higher
- Composer
- Node.js and PNPM
Installation
Clone the repository
laravel new my-app --using=jeffersongoncalves/helpdeskkitv4 --database=mysql
Using filakit CLI
Or use filakit CLI for a simplified setup:
filakit new my-app --kit=jeffersongoncalves/helpdeskkitv4
Install filakit CLI:
composer global require jeffersongoncalves/filakit-cli
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
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
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
HelpDesk Kit comes pre-configured with a multi-guard authentication system that supports three types of users:
| Guard | Model | Panel | Path | Description |
|---|---|---|---|---|
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)
| Role | Password | |
|---|---|---|
| Admin | admin@helpdeskkit.com |
password |
| Operator | operator@helpdeskkit.com |
password |
| User | user@helpdeskkit.com |
password |
Help Desk System
HelpDesk Kit includes the filament-help-desk plugin, providing a complete support ticket system:
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)
- 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)
- Create new support tickets
- Track ticket status and history
- View operator responses
- Attach files to tickets
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
Panel Configuration
Panels can be customized through their respective providers:
app/Providers/Filament/AdminPanelProvider.phpapp/Providers/Filament/OperatorPanelProvider.phpapp/Providers/Filament/AppPanelProvider.phpapp/Providers/Filament/GuestPanelProvider.php
Alternatively, these settings are also consolidated in the config/helpdeskkit.php file for easier management.
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
Each panel has its own color scheme:
| Panel | Color | Theme CSS |
|---|---|---|
| Admin | Amber | resources/css/filament/admin/theme.css |
| Operator | Blue | resources/css/filament/operator/theme.css |
| App | Green | resources/css/filament/app/theme.css |
| Guest | - | resources/css/filament/guest/theme.css |
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
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
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: https://github.com/joaopaulolndev/filament-edit-profile
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
This project is licensed under the MIT License.
Credits
Developed by Jefferson Goncalves.