From f598028fe90bfdd26a0f33e127f88366cde1476d Mon Sep 17 00:00:00 2001
From: Mark Gregory <mark.gregory@mpba.co.uk>
Date: Fri, 12 Jun 2026 11:17:59 +0100
Subject: [PATCH] new helpdesk module now with kabann board

---
 .../Helpdesk/Docs/WMS_SUPPORT_MENU_PATCH.md   |  16 ++
 .../Http/Controllers/HelpdeskController.php   |  10 +-
 Modules/Helpdesk/Livewire/TicketCreate.php    |   4 +-
 .../Providers/HelpdeskServiceProvider.php     |   3 +
 .../views/components/html-editor.blade.php    |  58 ++--
 .../Helpdesk/Resources/views/index.blade.php  |   2 -
 .../views/livewire/ticket-create.blade.php    | 261 +++++++-----------
 .../views/partials/page-header.blade.php      |  36 +--
 Modules/Helpdesk/changelog.yaml               |   8 +
 Modules/Helpdesk/module.json                  |   2 +-
 resources/views/layouts/app/sidebar.blade.php |  81 +++++-
 resources/views/partials/head.blade.php       |  65 ++---
 12 files changed, 286 insertions(+), 260 deletions(-)
 create mode 100644 Modules/Helpdesk/Docs/WMS_SUPPORT_MENU_PATCH.md

diff --git a/Modules/Helpdesk/Docs/WMS_SUPPORT_MENU_PATCH.md b/Modules/Helpdesk/Docs/WMS_SUPPORT_MENU_PATCH.md
new file mode 100644
index 00000000..4c26b9c4
--- /dev/null
+++ b/Modules/Helpdesk/Docs/WMS_SUPPORT_MENU_PATCH.md
@@ -0,0 +1,16 @@
+# WMS Support Menu Patch
+
+Add this block to the main application sidebar inside `<nav class="wms-sidebar-nav">`, preferably after the Operations group and before Integration & Reporting.
+
+```blade
+@includeIf('helpdesk::partials.sidebar-support-menu')
+```
+
+The partial checks that the Helpdesk module is enabled through `nwidart/laravel-modules` when the Module facade exists, and also checks that the Helpdesk routes are registered before showing links.
+
+After adding the include, run:
+
+```bash
+artisan optimize:clear
+artisan octane:reload
+```
diff --git a/Modules/Helpdesk/Http/Controllers/HelpdeskController.php b/Modules/Helpdesk/Http/Controllers/HelpdeskController.php
index 68eb367b..e149b3ef 100644
--- a/Modules/Helpdesk/Http/Controllers/HelpdeskController.php
+++ b/Modules/Helpdesk/Http/Controllers/HelpdeskController.php
@@ -6,14 +6,20 @@ namespace Modules\Helpdesk\Http\Controllers;
 
 use App\Http\Controllers\Controller;
 use Illuminate\Contracts\View\View;
+use Illuminate\Support\HtmlString;
 
 final class HelpdeskController extends Controller
 {
     /**
-     * Display the Helpdesk module landing page.
+     * Display the Helpdesk module landing page inside the application shell.
+     *
+     * @return View
      */
     public function __invoke(): View
     {
-        return view('helpdesk::index');
+        return view('layouts.app', [
+            'title' => __('Helpdesk'),
+            'slot' => new HtmlString(view('helpdesk::index')->render()),
+        ]);
     }
 }
diff --git a/Modules/Helpdesk/Livewire/TicketCreate.php b/Modules/Helpdesk/Livewire/TicketCreate.php
index 4d5df4a5..a08d0d81 100644
--- a/Modules/Helpdesk/Livewire/TicketCreate.php
+++ b/Modules/Helpdesk/Livewire/TicketCreate.php
@@ -75,7 +75,9 @@ final class TicketCreate extends Component
 
         session()->flash('success', 'Ticket ' . $ticket->reference . ' has been created.');
 
-        return $this->redirectRoute('helpdesk.tickets.show', ['ticket' => $ticket->getKey()]);
+        return redirect()->route('helpdesk.tickets.show', [
+            'ticket' => $ticket,
+        ]);
     }
 
     /** @return View */
diff --git a/Modules/Helpdesk/Providers/HelpdeskServiceProvider.php b/Modules/Helpdesk/Providers/HelpdeskServiceProvider.php
index 739f4db3..55b99a7b 100644
--- a/Modules/Helpdesk/Providers/HelpdeskServiceProvider.php
+++ b/Modules/Helpdesk/Providers/HelpdeskServiceProvider.php
@@ -11,6 +11,7 @@ use Illuminate\Support\Facades\Gate;
 use Illuminate\Support\ServiceProvider;
 use Livewire\Livewire;
 use Modules\Helpdesk\Livewire\HelpdeskDashboardWidget;
+use Modules\Helpdesk\Livewire\KanbanBoard;
 use Modules\Helpdesk\Livewire\SettingsManager;
 use Modules\Helpdesk\Livewire\TicketCreate;
 use Modules\Helpdesk\Livewire\TicketIndex;
@@ -79,6 +80,7 @@ final class HelpdeskServiceProvider extends ServiceProvider
         Livewire::component('helpdesk.ticket-create', TicketCreate::class);
         Livewire::component('helpdesk.ticket-show', TicketShow::class);
         Livewire::component('helpdesk.dashboard-widget', HelpdeskDashboardWidget::class);
+        Livewire::component('helpdesk.kanban-board', KanbanBoard::class);
         Livewire::component('helpdesk.settings-manager', SettingsManager::class);
     }
 
@@ -162,6 +164,7 @@ final class HelpdeskServiceProvider extends ServiceProvider
         $this->loadViewsFrom(array_merge($this->getPublishableViewPaths(), [$sourcePath]), ModuleInfo::nameLower());
 
         Blade::componentNamespace('Modules\Helpdesk\View\Components', 'helpdesk');
+        Blade::anonymousComponentPath($sourcePath . '/components', 'helpdesk');
     }
 
     /**
diff --git a/Modules/Helpdesk/Resources/views/components/html-editor.blade.php b/Modules/Helpdesk/Resources/views/components/html-editor.blade.php
index 7536a228..ea9af57b 100644
--- a/Modules/Helpdesk/Resources/views/components/html-editor.blade.php
+++ b/Modules/Helpdesk/Resources/views/components/html-editor.blade.php
@@ -4,35 +4,36 @@
     'placeholder' => 'Write your message...',
 ])
 
-@php($model = $attributes->wire('model')->value())
+@php
+    $wireModel = $attributes->wire('model');
+    $model = $wireModel->value();
+    $initialValue = $model ? data_get($this, $model, '') : '';
+@endphp
 
 <div
-    {{ $attributes->except(['wire:model'])->merge(['class' => 'space-y-2']) }}
+    {{ $attributes->whereDoesntStartWith('wire:model')->merge(['class' => 'space-y-2']) }}
     x-data="{
-        value: @entangle($model),
+        model: @js($model),
+        value: @js($initialValue),
+        sync() {
+            this.value = this.$refs.editor.innerHTML;
+            if (this.model) {
+                this.$wire.set(this.model, this.value, false);
+            }
+        },
         command(action, value = null) {
+            this.$refs.editor.focus();
             document.execCommand(action, false, value);
             this.sync();
         },
-        sync() {
-            this.value = this.$refs.editor.innerHTML;
-        },
         init() {
             this.$refs.editor.innerHTML = this.value || '';
-
-            this.$watch('value', (nextValue) => {
-                if (document.activeElement !== this.$refs.editor && this.$refs.editor.innerHTML !== (nextValue || '')) {
-                    this.$refs.editor.innerHTML = nextValue || '';
-                }
-            });
         }
     }"
 >
     <label class="block text-sm font-medium text-zinc-700 dark:text-zinc-200">{{ $label }}</label>
 
-    <input type="hidden" x-model="value" />
-
-    <div class="overflow-hidden rounded-xl border border-zinc-300 bg-white shadow-sm dark:border-zinc-700 dark:bg-zinc-950">
+    <div class="overflow-hidden rounded-xl border border-zinc-300 bg-white shadow-sm dark:border-zinc-700 dark:bg-zinc-950" wire:ignore>
         <div class="flex flex-wrap gap-1 border-b border-zinc-200 bg-zinc-50 p-2 dark:border-zinc-800 dark:bg-zinc-900">
             <button type="button" x-on:click="command('bold')" class="rounded-lg px-2 py-1 text-sm font-bold hover:bg-zinc-200 dark:hover:bg-zinc-800">B</button>
             <button type="button" x-on:click="command('italic')" class="rounded-lg px-2 py-1 text-sm italic hover:bg-zinc-200 dark:hover:bg-zinc-800">I</button>
@@ -44,20 +45,19 @@
             <button type="button" x-on:click="command('removeFormat')" class="rounded-lg px-2 py-1 text-sm hover:bg-zinc-200 dark:hover:bg-zinc-800">Clear</button>
         </div>
 
-        <div wire:ignore>
-            <div
-                x-ref="editor"
-                contenteditable="true"
-                x-on:input.debounce.500ms="sync"
-                x-on:blur="sync"
-                x-on:keydown.enter.stop
-                class="prose prose-sm min-h-[{{ (int) $rows * 28 }}px] max-w-none bg-white p-4 text-sm text-zinc-900 outline-none dark:prose-invert dark:bg-zinc-950 dark:text-zinc-100"
-                data-placeholder="{{ $placeholder }}"
-            ></div>
-        </div>
+        <div
+            x-ref="editor"
+            contenteditable="true"
+            x-on:input.debounce.300ms="sync"
+            x-on:blur="sync"
+            class="prose prose-sm min-h-[{{ (int) $rows * 28 }}px] max-w-none bg-white p-4 text-sm text-zinc-900 outline-none dark:prose-invert dark:bg-zinc-950 dark:text-zinc-100"
+            data-placeholder="{{ $placeholder }}"
+        ></div>
     </div>
 
-    @error($model)
-        <div class="text-sm text-red-600">{{ $message }}</div>
-    @enderror
+    @if($model)
+        @error($model)
+            <div class="text-sm text-red-600">{{ $message }}</div>
+        @enderror
+    @endif
 </div>
diff --git a/Modules/Helpdesk/Resources/views/index.blade.php b/Modules/Helpdesk/Resources/views/index.blade.php
index 074e54e1..73a260dd 100644
--- a/Modules/Helpdesk/Resources/views/index.blade.php
+++ b/Modules/Helpdesk/Resources/views/index.blade.php
@@ -1,4 +1,3 @@
-<x-app-layout :title="__('Helpdesk')">
     <div class="space-y-6">
         <div class="overflow-hidden rounded-3xl border border-zinc-200 bg-white shadow-sm dark:border-zinc-700 dark:bg-zinc-900">
             <div class="bg-gradient-to-br from-slate-950 via-slate-900 to-blue-950 px-6 py-8 text-white">
@@ -43,4 +42,3 @@
 
         <livewire:helpdesk.dashboard-widget />
     </div>
-</x-app-layout>
diff --git a/Modules/Helpdesk/Resources/views/livewire/ticket-create.blade.php b/Modules/Helpdesk/Resources/views/livewire/ticket-create.blade.php
index aa6d4d5e..5402a331 100644
--- a/Modules/Helpdesk/Resources/views/livewire/ticket-create.blade.php
+++ b/Modules/Helpdesk/Resources/views/livewire/ticket-create.blade.php
@@ -1,176 +1,103 @@
-<div>
+<div class="space-y-6">
     @include('helpdesk::partials.page-header', [
-        'title' => 'Create Ticket',
-        'subtitle' => 'Raise a new support request with priority, project, category and full details.',
-    ])
+         'eyebrow' => 'Helpdesk',
+         'title' => 'Create Ticket',
+         'subtitle' => 'Raise a new support request with priority, project, category and full details.',
+      ])
 
-<form wire:submit.prevent="save" class="space-y-6">
-    <div class="rounded-2xl border border-slate-200 bg-white shadow-sm">
-        <div class="border-b border-slate-200 px-6 py-4">
-            <h2 class="text-lg font-semibold text-slate-900">Ticket details</h2>
-        </div>
-
-        <div class="grid gap-6 p-6 lg:grid-cols-2">
-            <div class="lg:col-span-2">
-                <label class="block text-sm font-semibold text-slate-700" for="title">
-                    Title
-                </label>
-
-                <input
-                    id="title"
-                    type="text"
-                    wire:model.defer="title"
-                    class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
-                >
-
-                @error('title')
-                <p class="mt-2 text-sm text-red-600">{{ $message }}</p>
-                @enderror
+    <form wire:submit.prevent="save" class="space-y-6">
+        <div class="rounded-2xl border border-zinc-200 bg-white shadow-sm dark:border-zinc-700 dark:bg-zinc-900">
+            <div class="border-b border-zinc-200 px-6 py-4 dark:border-zinc-700">
+                <h2 class="text-lg font-semibold text-zinc-900 dark:text-zinc-100">Ticket details</h2>
+                <p class="mt-1 text-sm text-zinc-500 dark:text-zinc-400">Capture the request clearly so the support workflow can route and notify correctly.</p>
             </div>
 
-            <div>
-                <label class="block text-sm font-semibold text-slate-700" for="priority_id">
-                    Priority
-                </label>
-
-                <select
-                    id="priority_id"
-                    wire:model.defer="priority_id"
-                    class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
-                >
-                    <option value="">Select priority</option>
-
-                    @foreach ($priorities as $priority)
-                        <option value="{{ $priority->id }}">{{ $priority->name }}</option>
-                    @endforeach
-                </select>
-
-                @error('priority_id')
-                <p class="mt-2 text-sm text-red-600">{{ $message }}</p>
-                @enderror
-            </div>
-
-            <div>
-                <label class="block text-sm font-semibold text-slate-700" for="category_id">
-                    Category
-                </label>
-
-                <select
-                    id="category_id"
-                    wire:model.defer="category_id"
-                    class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
-                >
-                    <option value="">Select category</option>
-
-                    @foreach ($categories as $category)
-                        <option value="{{ $category->id }}">{{ $category->name }}</option>
-                    @endforeach
-                </select>
-
-                @error('category_id')
-                <p class="mt-2 text-sm text-red-600">{{ $message }}</p>
-                @enderror
-            </div>
-
-            <div>
-                <label class="block text-sm font-semibold text-slate-700" for="project_id">
-                    Project
-                </label>
-
-                <select
-                    id="project_id"
-                    wire:model.defer="project_id"
-                    class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
-                >
-                    <option value="">Select project</option>
-
-                    @foreach ($projects as $project)
-                        <option value="{{ $project->id }}">{{ $project->name }}</option>
-                    @endforeach
-                </select>
-
-                @error('project_id')
-                <p class="mt-2 text-sm text-red-600">{{ $message }}</p>
-                @enderror
-            </div>
-
-            <div>
-                <label class="block text-sm font-semibold text-slate-700" for="team_id">
-                    Team
-                </label>
-
-                <select
-                    id="team_id"
-                    wire:model.defer="team_id"
-                    class="mt-2 block w-full rounded-xl border-slate-300 shadow-sm focus:border-blue-500 focus:ring-blue-500"
-                >
-                    <option value="">Select team</option>
-
-                    @foreach ($teams as $team)
-                        <option value="{{ $team->id }}">{{ $team->name }}</option>
-                    @endforeach
-                </select>
-
-                @error('team_id')
-                <p class="mt-2 text-sm text-red-600">{{ $message }}</p>
-                @enderror
-            </div>
-
-            <div class="lg:col-span-2">
-                <label class="block text-sm font-semibold text-slate-700" for="details_editor">
-                    Details
-                </label>
-
-                <div wire:ignore class="mt-2">
-                    <textarea id="details_editor">{{ $details }}</textarea>
+            <div class="grid gap-6 p-6 lg:grid-cols-2">
+                <div class="lg:col-span-2">
+                    <label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="subject">Subject</label>
+                    <input id="subject" type="text" wire:model.defer="subject" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100" data-dusk="ticket-subject">
+                    @error('subject') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
                 </div>
 
-                @error('details')
-                <p class="mt-2 text-sm text-red-600">{{ $message }}</p>
-                @enderror
+                @if($companies->isNotEmpty())
+                    <div>
+                        <label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="company_id">Company</label>
+                        <select id="company_id" wire:model.defer="company_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
+                            <option value="">Select company</option>
+                            @foreach ($companies as $company)
+                                <option value="{{ $company->id }}">{{ $company->name }}</option>
+                            @endforeach
+                        </select>
+                        @error('company_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
+                    </div>
+                @endif
+
+                <div>
+                    <label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="priority_id">Priority</label>
+                    <select id="priority_id" wire:model.defer="priority_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100" data-dusk="ticket-priority">
+                        <option value="">Select priority</option>
+                        @foreach ($priorities as $priority)
+                            <option value="{{ $priority->id }}">{{ $priority->name }}</option>
+                        @endforeach
+                    </select>
+                    @error('priority_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
+                </div>
+
+                <div>
+                    <label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="category_id">Category</label>
+                    <select id="category_id" wire:model.defer="category_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
+                        <option value="">Select category</option>
+                        @foreach ($categories as $category)
+                            <option value="{{ $category->id }}">{{ $category->name }}</option>
+                        @endforeach
+                    </select>
+                    @error('category_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
+                </div>
+
+                <div>
+                    <label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="project_id">Project</label>
+                    <select id="project_id" wire:model.defer="project_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
+                        <option value="">Select project</option>
+                        @foreach ($projects as $project)
+                            <option value="{{ $project->id }}">{{ $project->title ?? $project->name }}</option>
+                        @endforeach
+                    </select>
+                    @error('project_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
+                </div>
+
+                <div>
+                    <label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="team_id">Team</label>
+                    <select id="team_id" wire:model.defer="team_id" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
+                        <option value="">Select team</option>
+                        @foreach ($teams as $team)
+                            <option value="{{ $team->id }}">{{ $team->name }}</option>
+                        @endforeach
+                    </select>
+                    @error('team_id') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
+                </div>
+
+                <div>
+                    <label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="due_at">Due date</label>
+                    <input id="due_at" type="date" wire:model.defer="due_at" class="mt-2 block w-full rounded-xl border-zinc-300 shadow-sm focus:border-blue-500 focus:ring-blue-500 dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
+                    @error('due_at') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
+                </div>
+
+                <div class="lg:col-span-2">
+                    <x-helpdesk::html-editor dusk="ticket-body-editor" wire:model="body" label="Details" rows="10" placeholder="Describe the issue, expected outcome, steps to reproduce and any useful context..." />
+                </div>
+
+                <div class="lg:col-span-2">
+                    <label class="block text-sm font-semibold text-zinc-700 dark:text-zinc-200" for="attachments">Attachments</label>
+                    <input id="attachments" type="file" wire:model="attachments" multiple class="mt-2 block w-full rounded-xl border border-zinc-300 bg-white px-3 py-2 text-sm shadow-sm dark:border-zinc-700 dark:bg-zinc-950 dark:text-zinc-100">
+                    @error('attachments') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
+                    @error('attachments.*') <p class="mt-2 text-sm text-red-600">{{ $message }}</p> @enderror
+                </div>
+            </div>
+
+            <div class="flex items-center justify-end gap-3 border-t border-zinc-200 px-6 py-4 dark:border-zinc-700">
+                <a href="{{ route('helpdesk.tickets.index') }}" wire:navigate class="rounded-xl border border-zinc-300 px-4 py-2 text-sm font-semibold text-zinc-700 hover:bg-zinc-50 dark:border-zinc-700 dark:text-zinc-200 dark:hover:bg-zinc-800">Cancel</a>
+                <button type="submit" class="rounded-xl bg-blue-600 px-5 py-2 text-sm font-semibold text-white shadow-sm hover:bg-blue-700" data-dusk="ticket-create-submit">Create Ticket</button>
             </div>
         </div>
-
-        <div class="flex items-center justify-end gap-3 border-t border-slate-200 px-6 py-4">
-            <a
-                href="{{ route('helpdesk.tickets.index') }}"
-                class="rounded-xl border border-slate-300 px-4 py-2 text-sm font-semibold text-slate-700 hover:bg-slate-50"
-            >
-                Cancel
-            </a>
-
-            <button
-                type="submit"
-                class="rounded-xl bg-blue-600 px-5 py-2 text-sm font-semibold text-white shadow-sm hover:bg-blue-700"
-            >
-                Create Ticket
-            </button>
-        </div>
-    </div>
-</form>
+    </form>
 </div>
-
-@push('scripts')
-<script>
-    document.addEventListener('livewire:init', function () {
-        const textarea = document.getElementById('details_editor');
-
-        if (!textarea || textarea.dataset.initialised === '1') {
-            return;
-        }
-
-        textarea.dataset.initialised = '1';
-
-        const editor = new EasyMDE({
-            element: textarea,
-            spellChecker: false,
-            status: false,
-            forceSync: true
-        });
-
-        editor.codemirror.on('change', function () {
-            @this.set('details', editor.value(), false);
-        });
-    });
-</script>
-@endpush
diff --git a/Modules/Helpdesk/Resources/views/partials/page-header.blade.php b/Modules/Helpdesk/Resources/views/partials/page-header.blade.php
index 7311698f..714cd9fe 100644
--- a/Modules/Helpdesk/Resources/views/partials/page-header.blade.php
+++ b/Modules/Helpdesk/Resources/views/partials/page-header.blade.php
@@ -1,27 +1,17 @@
-<div class="mb-8 overflow-hidden rounded-3xl border border-slate-200 bg-white shadow-sm">
-    <div class="bg-gradient-to-r from-slate-950 via-slate-900 to-blue-950 px-6 py-8 text-white">
-        <div class="flex flex-col gap-4 lg:flex-row lg:items-center lg:justify-between">
-            <div>
-                <p class="text-sm font-semibold uppercase tracking-[0.3em] text-blue-200">
-                    Helpdesk
-                </p>
+<div class="mb-8 overflow-hidden rounded-3xl border border-slate-800 bg-slate-950 shadow-sm">
+    <div class="px-6 py-8 text-white">
+        <p class="text-sm font-semibold uppercase tracking-[0.3em] text-blue-300">
+            {{ $eyebrow ?? 'Helpdesk' }}
+        </p>
 
-                <h1 class="mt-2 text-3xl font-bold tracking-tight">
-                    {{ $title ?? 'Helpdesk' }}
-                </h1>
+        <h1 class="mt-3 text-3xl font-bold tracking-tight">
+            {{ $title ?? 'Helpdesk' }}
+        </h1>
 
-                @isset($subtitle)
-                    <p class="mt-2 max-w-3xl text-sm text-slate-300">
-                        {{ $subtitle }}
-                    </p>
-                @endisset
-            </div>
-
-            @isset($actions)
-                <div class="flex flex-wrap items-center gap-3">
-                    {{ $actions }}
-                </div>
-            @endisset
-        </div>
+        @if(! empty($subtitle))
+            <p class="mt-2 max-w-3xl text-sm text-slate-300">
+                {{ $subtitle }}
+            </p>
+        @endif
     </div>
 </div>
diff --git a/Modules/Helpdesk/changelog.yaml b/Modules/Helpdesk/changelog.yaml
index 6ca969ac..4a475645 100755
--- a/Modules/Helpdesk/changelog.yaml
+++ b/Modules/Helpdesk/changelog.yaml
@@ -13,3 +13,11 @@ versions:
       - Added Kanban PHPUnit and Dusk coverage.
       - Added Kanban navigation links to the dashboard and ticket list.
 
+  "1.0.3":
+    changed:
+      - Fixed Helpdesk dashboard rendering by removing dependency on missing x-app-layout/x-layouts.app components.
+      - Registered anonymous Helpdesk Blade components so x-helpdesk component views resolve correctly.
+      - Registered the Kanban Livewire component in the Helpdesk service provider.
+      - Rebuilt the ticket create page to use the correct subject/body Livewire properties.
+      - Stabilised the rich HTML editor so typing no longer clears the field or accidentally submits the ticket form.
+      - Added root layout support-menu integration instructions for enabled Helpdesk modules.
diff --git a/Modules/Helpdesk/module.json b/Modules/Helpdesk/module.json
index 90a5b3e1..17229611 100644
--- a/Modules/Helpdesk/module.json
+++ b/Modules/Helpdesk/module.json
@@ -13,5 +13,5 @@
         "Modules\\Helpdesk\\Providers\\HelpdeskServiceProvider"
     ],
     "files": [],
-    "version": "1.0.2"
+    "version": "1.0.3"
 }
diff --git a/resources/views/layouts/app/sidebar.blade.php b/resources/views/layouts/app/sidebar.blade.php
index 57dbbb06..21f2d26f 100644
--- a/resources/views/layouts/app/sidebar.blade.php
+++ b/resources/views/layouts/app/sidebar.blade.php
@@ -1,9 +1,6 @@
 <!DOCTYPE html>
 <html lang="{{ str_replace('_', '-', app()->getLocale()) }}" class="dark">
-    <head>
-        @include('partials.head')
-    </head>
-
+    @include('partials.head')
     <body class="min-h-screen bg-white text-zinc-950 antialiased dark:bg-zinc-950 dark:text-zinc-100">
         <div class="wms-app-shell" data-wms-shell data-wms-mobile-shell>
             <button type="button" class="wms-mobile-overlay" data-wms-mobile-close aria-label="{{ __('Close navigation menu') }}"></button>
@@ -85,6 +82,82 @@
                             @endif
                     </div>
 
+                    {{-- Support Portal--}}
+                    @php
+                        $helpdeskEnabled = Route::has('helpdesk.index') || Route::has('helpdesk.tickets.index');
+
+                        $helpdeskSettingsRoute = Route::has('helpdesk.settings')
+                            ? 'helpdesk.settings'
+                            : (Route::has('helpdesk.settings.index') ? 'helpdesk.settings.index' : null);
+
+                        $helpdeskKanbanRoute = Route::has('helpdesk.kanban')
+                            ? 'helpdesk.kanban'
+                            : (Route::has('helpdesk.kanban.index') ? 'helpdesk.kanban.index' : null);
+
+                        $helpdeskGitRoute = Route::has('helpdesk.git.index')
+                            ? 'helpdesk.git.index'
+                            : null;
+
+                        $helpdeskWorkflowRoute = Route::has('helpdesk.workflow-templates.index')
+                            ? 'helpdesk.workflow-templates.index'
+                            : null;
+                    @endphp
+
+                    @if($helpdeskEnabled)
+                        <div class="wms-sidebar-group">
+                            <div class="wms-sidebar-heading" data-wms-sidebar-label>{{ __('Support') }}</div>
+
+                            @if(Route::has('helpdesk.index'))
+                                <a href="{{ route('helpdesk.index') }}" wire:navigate class="wms-sidebar-link @if(request()->routeIs('helpdesk.index')) is-active @endif" title="{{ __('Helpdesk Dashboard') }}">
+                                    <i class="fa-solid fa-headset wms-sidebar-icon" aria-hidden="true"></i>
+                                    <span data-wms-sidebar-label>{{ __('Dashboard') }}</span>
+                                </a>
+                            @endif
+
+                            @if(Route::has('helpdesk.tickets.index'))
+                                <a href="{{ route('helpdesk.tickets.index') }}" wire:navigate class="wms-sidebar-link @if(request()->routeIs('helpdesk.tickets.*')) is-active @endif" title="{{ __('Tickets') }}">
+                                    <i class="fa-solid fa-ticket wms-sidebar-icon" aria-hidden="true"></i>
+                                    <span data-wms-sidebar-label>{{ __('Tickets') }}</span>
+                                </a>
+                            @endif
+
+                            @if(Route::has('helpdesk.tickets.create'))
+                                <a href="{{ route('helpdesk.tickets.create') }}" wire:navigate class="wms-sidebar-link @if(request()->routeIs('helpdesk.tickets.create')) is-active @endif" title="{{ __('Raise Ticket') }}">
+                                    <i class="fa-solid fa-circle-plus wms-sidebar-icon" aria-hidden="true"></i>
+                                    <span data-wms-sidebar-label>{{ __('Raise Ticket') }}</span>
+                                </a>
+                            @endif
+
+                            @if($helpdeskKanbanRoute)
+                                <a href="{{ route($helpdeskKanbanRoute) }}" wire:navigate class="wms-sidebar-link @if(request()->routeIs('helpdesk.kanban*')) is-active @endif" title="{{ __('Kanban') }}">
+                                    <i class="fa-solid fa-table-columns wms-sidebar-icon" aria-hidden="true"></i>
+                                    <span data-wms-sidebar-label>{{ __('Kanban') }}</span>
+                                </a>
+                            @endif
+
+                            @if($helpdeskGitRoute)
+                                <a href="{{ route($helpdeskGitRoute) }}" wire:navigate class="wms-sidebar-link @if(request()->routeIs('helpdesk.git.*')) is-active @endif" title="{{ __('Git Tracking') }}">
+                                    <i class="fa-solid fa-code-commit wms-sidebar-icon" aria-hidden="true"></i>
+                                    <span data-wms-sidebar-label>{{ __('Git Tracking') }}</span>
+                                </a>
+                            @endif
+
+                            @if($helpdeskWorkflowRoute)
+                                <a href="{{ route($helpdeskWorkflowRoute) }}" wire:navigate class="wms-sidebar-link @if(request()->routeIs('helpdesk.workflow-templates.*')) is-active @endif" title="{{ __('Workflow Emails') }}">
+                                    <i class="fa-solid fa-envelope-circle-check wms-sidebar-icon" aria-hidden="true"></i>
+                                    <span data-wms-sidebar-label>{{ __('Workflow Emails') }}</span>
+                                </a>
+                            @endif
+
+                            @if($helpdeskSettingsRoute)
+                                <a href="{{ route($helpdeskSettingsRoute) }}" wire:navigate class="wms-sidebar-link @if(request()->routeIs('helpdesk.settings*')) is-active @endif" title="{{ __('Helpdesk Settings') }}">
+                                    <i class="fa-solid fa-gears wms-sidebar-icon" aria-hidden="true"></i>
+                                    <span data-wms-sidebar-label>{{ __('Settings') }}</span>
+                                </a>
+                            @endif
+                        </div>
+                    @endif
+                    {{-- Support Portal end --}}
                     <div class="wms-sidebar-group">
                         <div class="wms-sidebar-heading" data-wms-sidebar-label>{{ __('Integration & Reporting') }}</div>
 
diff --git a/resources/views/partials/head.blade.php b/resources/views/partials/head.blade.php
index 0be36de0..672fd824 100644
--- a/resources/views/partials/head.blade.php
+++ b/resources/views/partials/head.blade.php
@@ -1,38 +1,41 @@
-<meta charset="utf-8" />
-<meta name="viewport" content="width=device-width, initial-scale=1.0" />
+<head>
+        <meta charset="utf-8" />
+        <meta name="viewport" content="width=device-width, initial-scale=1.0" />
 
-<title>
-    {{ filled($title ?? null) ? $title.' - '.config('app.name', 'Laravel') : config('app.name', 'Laravel') }}
-</title>
+        <title>
+            {{ filled($title ?? null) ? $title.' - '.config('app.name', 'Laravel') : config('app.name', 'Laravel') }}
+        </title>
 
-<link rel="icon" href="{{ asset('favicons/favicon.ico') }}" sizes="any">
-<link rel="icon" href="{{ asset('favicons/favicon.svg') }}" type="image/svg+xml">
+        <link rel="icon" href="{{ asset('favicons/favicon.ico') }}" sizes="any">
+        <link rel="icon" href="{{ asset('favicons/favicon.svg') }}" type="image/svg+xml">
 
-<link rel="icon" type="image/png" sizes="16x16" href="{{ asset('favicons/favicon-16x16.png') }}">
-<link rel="icon" type="image/png" sizes="32x32" href="{{ asset('favicons/favicon-32x32.png') }}">
-<link rel="icon" type="image/png" sizes="48x48" href="{{ asset('favicons/favicon-48x48.png') }}">
-<link rel="icon" type="image/png" sizes="64x64" href="{{ asset('favicons/favicon-64x64.png') }}">
-<link rel="icon" type="image/png" sizes="96x96" href="{{ asset('favicons/favicon-96x96.png') }}">
-<link rel="icon" type="image/png" sizes="128x128" href="{{ asset('favicons/favicon-128x128.png') }}">
-<link rel="icon" type="image/png" sizes="192x192" href="{{ asset('favicons/favicon-192x192.png') }}">
-<link rel="icon" type="image/png" sizes="256x256" href="{{ asset('favicons/favicon-256x256.png') }}">
-<link rel="icon" type="image/png" sizes="384x384" href="{{ asset('favicons/favicon-384x384.png') }}">
-<link rel="icon" type="image/png" sizes="512x512" href="{{ asset('favicons/favicon-512x512.png') }}">
+        <link rel="icon" type="image/png" sizes="16x16" href="{{ asset('favicons/favicon-16x16.png') }}">
+        <link rel="icon" type="image/png" sizes="32x32" href="{{ asset('favicons/favicon-32x32.png') }}">
+        <link rel="icon" type="image/png" sizes="48x48" href="{{ asset('favicons/favicon-48x48.png') }}">
+        <link rel="icon" type="image/png" sizes="64x64" href="{{ asset('favicons/favicon-64x64.png') }}">
+        <link rel="icon" type="image/png" sizes="96x96" href="{{ asset('favicons/favicon-96x96.png') }}">
+        <link rel="icon" type="image/png" sizes="128x128" href="{{ asset('favicons/favicon-128x128.png') }}">
+        <link rel="icon" type="image/png" sizes="192x192" href="{{ asset('favicons/favicon-192x192.png') }}">
+        <link rel="icon" type="image/png" sizes="256x256" href="{{ asset('favicons/favicon-256x256.png') }}">
+        <link rel="icon" type="image/png" sizes="384x384" href="{{ asset('favicons/favicon-384x384.png') }}">
+        <link rel="icon" type="image/png" sizes="512x512" href="{{ asset('favicons/favicon-512x512.png') }}">
 
-<link rel="apple-touch-icon" sizes="180x180" href="{{ asset('favicons/apple-touch-icon.png') }}">
-<link rel="manifest" href="{{ asset('favicons/site.webmanifest') }}">
+        <link rel="apple-touch-icon" sizes="180x180" href="{{ asset('favicons/apple-touch-icon.png') }}">
+        <link rel="manifest" href="{{ asset('favicons/site.webmanifest') }}">
 
-<meta name="application-name" content="{{ config('app.name') }}">
-<meta name="apple-mobile-web-app-title" content="{{ config('app.name') }}">
-<meta name="mobile-web-app-capable" content="yes">
-<meta name="apple-mobile-web-app-capable" content="yes">
-<meta name="apple-mobile-web-app-status-bar-style" content="default">
-<meta name="format-detection" content="telephone=no">
-<meta name="msapplication-config" content="{{ asset('favicons/browserconfig.xml') }}">
-<meta name="msapplication-TileImage" content="{{ asset('favicons/mstile-150x150.png') }}">
-<meta name="theme-color" content="#ffffff">
+        <meta name="application-name" content="{{ config('app.name') }}">
+        <meta name="apple-mobile-web-app-title" content="{{ config('app.name') }}">
+        <meta name="mobile-web-app-capable" content="yes">
+        <meta name="apple-mobile-web-app-capable" content="yes">
+        <meta name="apple-mobile-web-app-status-bar-style" content="default">
+        <meta name="format-detection" content="telephone=no">
+        <meta name="msapplication-config" content="{{ asset('favicons/browserconfig.xml') }}">
+        <meta name="msapplication-TileImage" content="{{ asset('favicons/mstile-150x150.png') }}">
+        <meta name="theme-color" content="#ffffff">
 
-@fonts
+        @fonts
 
-@vite(['resources/css/app.css', 'resources/js/app.js'])
-@fluxAppearance
+        @vite(['resources/css/app.css', 'resources/js/app.js'])
+        @fluxAppearance
+
+</head>