Ticket Support System

A premium, real-time React ticket support package for SaaS applications.

Features

• Real-time Messaging: Powered by Socket.IO for live agent/customer chat.
• Auto-Discovery: Automatic tenant resolution based on the hosting domain.
• User Identification: Seamlessly maps your app's local users to support tickets.
• Theming: Configurable primary colors to match your brand.
• Mobile Responsive: Works beautifully on all devices.

Installation

npm install ticket-support-system

Usage

import { SupportWidget } from 'ticket-support-system';
import 'ticket-support-system/dist/style.css';

function App() {
  return (
    <div>
      <SupportWidget 
        serverUrl="https://your-support-api.com"
        localStorageKey="user_session"
        userFieldMap={{
          id: 'uuid',
          name: 'displayName',
          email: 'emailAddress'
        }}
        theme={{ primaryColor: '#6366f1' }}
      />
    </div>
  );
}

Configuration

| Prop | Type | Description | | --- | --- | --- | | serverUrl | string | The URL of your support backend. | | localStorageKey | string | The key where your user info is stored in localStorage. | | userFieldMap | object | Mapping from your user object fields to id, name, and email. | | position | 'bottom-right' \| 'bottom-left' | Widget trigger position. | | theme | object | Customize the widget look (e.g., primaryColor). |