#HelpDeskKit — Starter Kit for Help Desk with Laravel 13 & Filament 3

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

#Features

#Multi-Panel Architecture

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

#Help Desk System

Complete ticketing system powered by filament-help-desk:

• Ticket Management — Create, assign, update status and priority
• Departments & Categories — Organize tickets by team and type
• Comments & 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

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

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

#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

• PHP 8.3+
• Composer
• Node.js with PNPM
• MySQL, PostgreSQL, or SQLite

#Installation

#Using Laravel Installer

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

#Using FilaKit CLI

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

#Automated Setup

php install.php

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

#Manual Setup

composer install
pnpm install
cp .env.example .env
php artisan key:generate
php artisan migrate
pnpm run build
php artisan serve

#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

# 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

#Panel Providers

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

• AdminPanelProvider.php
• AppPanelProvider.php
• OperatorPanelProvider.php
• GuestPanelProvider.php

#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

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

#Tech Stack

#License

MIT License

#Credits

Developed by Jefferson Gonçalves.