VUX Events & Ticketing Platform

2. Event Data Model & Registration Fields

Events in VUX are modeled in Cloud Firestore with support for custom dynamic intake forms, approval gates, and location coordinates:

interface Event {
  id: string;
  hostId: string;
  title: string;
  description: string;
  date: string;
  time: string;
  location: string;
  coordinates?: { lat: number; lng: number };
  isVirtual?: boolean;
  meetingLink?: string;
  category: string;
  visibility: 'public' | 'private';
  status: 'draft' | 'published' | 'completed' | 'cancelled';
  isApprovalRequired: boolean;
  capacity?: number;
  ticketTypes?: TicketType[];
  registrationFields?: {
    label: string;
    type: 'text' | 'email' | 'longtext' | 'select' | 'multichoice' | 'checkbox' | 'phone';
    required: boolean;
    options?: string[];
  }[];
  speakers?: Speaker[];
  sponsors?: Sponsor[];
  polls?: Poll[];
}

3. Ticket Tiers & Capacity Controls

Organizers can configure multiple ticket types per event with dedicated pricing, capacity caps, and automatic waitlisting:

4. Cryptographic QR Passes & PDF Generator

Every approved RSVP creates an atomic ticket pass with a cryptographic signature. Passes are rendered dynamically in-browser using jspdf and qrcode.react:

{
  "tkt": "TKT-A8F2B1C9",
  "evt": "evt_hackathon_2026",
  "uid": "usr_829102",
  "tier": "General Admission",
  "sig": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}

5. Door Scanner & Anti-Fraud Verification

The door scanner app (src/pages/Dashboard.tsx) operates directly in web browsers via html5-qrcode:

• Hardware Agnostic: Runs on iPhones, Android devices, and USB barcode scanners.
• Single-Entry Atomic Enforcement: Checks the Firestore RSVP document and sets checkedIn: true with an ISO timestamp. Re-scans instantly trigger a duplicate entry alert with the original check-in time.

6. AI-Powered Generation (Google Gemini)

Organizers can generate compelling event descriptions, schedules, and speaker bios using the integrated Google Gemini model (src/lib/gemini.ts):

import { generateEventSchedule } from '@/lib/gemini';

// Auto-generate high-impact event agenda
const schedule = await generateEventSchedule({
  title: "Kontyra Edge Summit 2026",
  topic: "High-performance edge workers & WebSockets",
  durationHours: 6
});

7. Community Features: Polls, Contests & Speakers

VUX provides built-in attendee engagement modules:

8. Calendar Sync & Automated Dispatcher

Attendees can add events with one click to Google Calendar or download standard .ics files (src/services/GoogleCalendarService.ts). Transactional emails are dispatched via Resend from noreply@kontyra.name.ng.

9. Official React SDK: @kontyra/vux

Embed event listings and RSVP buttons into your React and Next.js applications:

npm install @kontyra/vux

import { VUXEventWidget, VUXRSVPButton } from '@kontyra/vux';

export function EventBanner() {
  return (
    <div className="vux-container">
      <VUXEventWidget eventId="evt_hackathon_2026" theme="dark" />
      <VUXRSVPButton
        eventId="evt_hackathon_2026"
        onSuccess={() => alert('RSVP Confirmed!')}
      />
    </div>
  );
}