README

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

A production-ready starter kit for building help desk and customer support applications. Built on Laravel 12, 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.2+
• 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

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.