Skip to main content
G
Goldfish Marketing

Based in Diani, Kwale County • Working across Kenya

Flagship Enterprise Systems & AI Operations Case StudyLas Vegas, Summerlin & Henderson, NV • Est. 1998 (28+ Seasons)● Official Domain Cutover (www.holidayillumination.com) Scheduled Next Week

Holiday Illumination LLC (“Highlights”): Luxury Estate Conversion & Geo-Smart Dispatch CRM

Operating from a permanent headquarters at 3030 Westwood Drive since 1998, Holiday Illumination LLC is Las Vegas's premier $2M-insured residential estate and commercial holiday lighting contractor. We engineered two interconnected enterprise systems: a Midnight Luxe Next.js 16 Public Conversion Platform and a private, role-based Operations & Dispatch CRM powered by 4-quadrant Las Vegas Valley ZIP routing and 24/7 Retell AI voice triage.

Deployment Notice

Public staging is live now; final DNS cutover to www.holidayillumination.com completes next week upon client registrar login handover. The Internal Operations & Dispatch CRM is a strictly private, zero-indexed (noindex, nofollow), RBAC-protected console and is not publicly linked.

Client Dossier

Holiday Illumination LLC

EST. 1998
Headquarters3030 Westwood Dr, Las Vegas, NV
Service MarketsSummerlin, Henderson & LV Valley
Coverage & Trust$2M Commercial Liability • 4.8★
Core StackNext.js 16 • React 19 • Supabase
Voice & Edge AuthRetell AI • Web Crypto HMAC-SHA256
Internal CRM Access🔒 Private RBAC Console
28+ Seasons
Operating Since 1998
3030 Westwood Dr HQ
4 Quadrants
LV Valley ZIP Engine
Eliminates 50-Mi Zigzag
5 Consoles
Role-Based CRM Hubs
Owner to Field Trucks
24/7 AI Voice
Retell AI Receptionist
Active / Overflow / Paused
2-Person
Bank Custody Controls
Field-to-Office Audit
107 Tests
Zero-Dep Quality Suite
100% Pass Across 4 Suites
01 // THE EXECUTIVE DIAGNOSIS

Four Seasonal Bottlenecks Constraining a 28-Year Market Leader

Despite an unmatched local reputation across guard-gated estates in Summerlin and Henderson, Holiday Illumination's legacy static web presence and manual scheduling created intense operational friction during the peak October–December installation window.

BOTTLENECK 01Before → After

The "50-Mile Cross-Valley" Routing Bottleneck

Estimators and installation crews were criss-crossing the Las Vegas Valley between Summerlin (Northwest), Henderson (Southeast), and the Southwest within the same day—burning prime billable hours in desert highway traffic instead of installing custom lighting.

✓

Resolved via an automated 4-Quadrant Las Vegas ZIP Clustering Engine that groups walkthroughs, warranty loops, and 3-truck installation manifests by sector.

BOTTLENECK 02Before → After

Dated Digital Perception vs. $2M-Insured Ultra-Luxury Service

Their legacy website failed to communicate the architectural sophistication of a $2M-insured commercial-grade contractor trusted by guard-gated estates (The Ridges, MacDonald Highlands) and major commercial centers.

✓

Replaced with a Midnight Luxe & Champagne Gold (60-30-10) Next.js 16 platform featuring an 8s estate transformation hero, interactive Day/Night slider, and $750 minimum anchor.

BOTTLENECK 03Before → After

Peak-Season Call Overflow & Unstructured Lead Intake

During the October–December rush, inbound calls for new estate estimates, complimentary warranty bulb repairs, and billing inquiries overwhelmed the front desk without automated triage or geographic qualification.

✓

Integrated a 24/7 Retell AI Voice Receptionist with instant mode controls (ACTIVE, OVERFLOW, PAUSED) and 1-tap routing into Estimate or Warranty calendars.

BOTTLENECK 04Before → After

Fragmented Field-to-Office Handshakes & Cash Custody

On-site walkthrough estimates, field cash/check deposit collections, warranty service calls, and January takedowns lacked a unified, auditable source of truth linking the receptionist, lead estimator, warranty runner, and installation trucks.

✓

Engineered a 5-workspace role-based CRM enforcing 2-person bank deposit reconciliation, mandatory installation photo proof, and automated January Climate Vault manifests.

02 // DUAL-SYSTEM ENTERPRISE TOPOLOGY

Two Interconnected Systems Sharing a Unified Geo-Smart Core

Rather than bolting third-party plugins onto a brochure site, we architected an isolated monorepo (apps/web and apps/crm) connected via a shared Las Vegas Valley Quadrant Engine, Supabase Postgres with Realtime Sync, and Retell AI voice webhooks.

Pillar A // Public Intake (apps/web)Public Web

Luxury Marketing & Estate Intake Web App

Engineered for instant LCP, high-net-worth trust conversion, and structured geographic lead capture before a human ever picks up the phone.

  • 01Cinema Transformation Hero & Day/Night Slider: 8s transformation video + interactive C9 LED luminance comparison.
  • 02Haute Halloween & Christmas Showcases: Gateway October estate installations + 20-question UHNW/Commercial FAQ.
  • 03Geo-Smart 3-Step Walkthrough Wizard: Captures property telemetry, validates 5-digit LV ZIP, and selects arrival window.
Commits Validated Lead + Sector→
Shared Domain & Routing CoreRealtime Hub

LV Valley Quadrant Engine, Supabase & Retell AI

Every web submission and inbound phone call passes through deterministic geographic zoning and state-machine persistence.

LV VALLEY QUADRANT ENGINE

Maps 5-digit ZIP codes into SUMMERLIN_NW, HENDERSON_GV, SW_ENTERPRISE, or CENTRAL_NLV.

SUPABASE POSTGRES + REALTIME SYNC

Dual-mode repository pattern with live cross-device synchronization and zero-data-loss local persistence fallback.

RETELL AI VOICE RECEPTIONIST

24/7 natural-voice phone triage classifying callers into New Estimate, Warranty Repair, or Billing queues.

Streams State to 5 Role Workspaces→
Pillar B // Operations CRM (apps/crm)🔒 Zero-Indexed

5-Role Operations & Fleet Dispatch Console

Protected by Edge HMAC-SHA256 JWT + 4-digit PIN authentication, isolating each staff member to their exact operational surface.

  • 1. Owner Command: KPIs, Cluster Manifests, Audit CSVHH-EEID-001
  • 2. Reception Desk: AI Call Triage & 2-Person Bank CustodyHH-EEID-002
  • 3. Estimator Suite: Live On-Site Quoter & Slot DispatcherHH-EEID-003
  • 4. Warranty Route: Anti-Zigzag Same-Quadrant CareHH-EEID-004
  • 5. Field Crews: Trucks 1–3 Photo Proof & TakedownsHH-EEID-005..007
Internal RBAC Deployment100% Audit Traceable
03 // PILLAR A — PUBLIC CONVERSION ARCHITECTURE

Midnight Luxe & Champagne Gold (60-30-10) Public Web Platform

Built on Next.js 16 App Router, React 19, and Tailwind CSS v4, the public platform pairs dark nocturnal sophistication (#090D16 Obsidian, #D4AF37 Champagne Gold, #961C28 Velvet Crimson) with behavioral conversion engineering.

HERO & LCP ENGINE

Full-Viewport Estate Transformation Video Hero

Instant-LCP server-rendered poster transitioning smoothly into an 8-second residential lighting transformation loop with verified social proof (★★★★★ 4.8 Google Rating • Trusted Since 1998) and $750 minimum package anchor microcopy.

● Instant LCP Poster • 8s Cinema Loop
INTERACTIVE PROOF

Day vs. Night C9 Luminescence Comparison Slider

Touch-physics and WCAG keyboard-accessible comparison slider allowing estate owners to drag across a Las Vegas residence to experience custom-cut commercial C9 LED luminance before and after dusk.

● Touch Physics • WCAG Keyboard Accessible
GATEWAY SEASON STRATEGY

Haute Halloween & Autumn Illumination Spotlight

Strategically positioned above Christmas services to capture October estate installations—featuring amber, violet, and crimson architectural uplighting, 12ft prop rigging, and 50-mph Mojave Desert wind anchoring with 1-click service pre-selection.

● 50-MPH Mojave Wind Rated • 1-Click Pre-Select
PERSONA OBJECTION CRUSHING

4 Trust Pillars & 20-Question Categorized FAQ

Engineered around Las Vegas buyer psychology: UHNW Guard-Gated Estates (Spanish barrel tile clip protection, <5 PSI spider lifts for paver motorcourts, NEC 80% load balancing, W-2 vetted crews) and Commercial/HOAs (nocturnal 10 PM–6 AM installs, ADA cable ramps, VendorCafe compliance, 3-year OpEx leases).

● Zero Tile Roof Damage • <5 PSI Spider Lifts
GEO-SMART INTAKE

3-Step Estate Walkthrough Scheduler Wizard

Resolves the homeowner’s 5-digit Las Vegas ZIP code in real time into one of four geographic quadrants (SUMMERLIN_NW, HENDERSON_GV, SW_ENTERPRISE, CENTRAL_NLV), offers Today/Tomorrow/Custom windows, and commits directly to Supabase as INTAKE_PENDING.

● 4-Quadrant Auto-Zoned • Direct Supabase Sync
BEHAVIORAL DESIGN SPELLS

Weibull Hesitation Concierge & Spotlight Telemetry

Features a Weibull 8.0-second dwell-hesitation engine and scroll-thrashing detector that gently surfaces a live phone concierge capsule when a prospect hesitates, paired with cursor-tracked radial amber uplighting (.spotlight-card).

● 8.0s Dwell Detector • Scroll-Thrash Recovery
04 // PILLAR B — PRIVATE INTERNAL OPERATIONS & DISPATCH CRM

Five Role-Isolated Workspaces Built for Zero Eye Fatigue

To protect proprietary operational telemetry and client estate records, the internal CRM operates as a standalone, zero-indexed (noindex, nofollow) Midnight Luxe Dark Console. Staff authenticate via 4-digit Role PINs verified at the Next.js Edge layer, unlocking only their authorized operational workspace.

🔒 Private Internal Deployment (URL Restricted to Authorized Staff)
WORKSPACE 01 // OWNER COMMAND CENTERHH-EEID-001 (Executive Oversight)

Pipeline Valuation, Valley Cluster Manifests & Audit Exports

  • ▸Real-time financial telemetry across pipeline valuation, collected 50% deposits, and outstanding final balances.
  • ▸Valley Route Cluster Manifests: interactive drill-down accordions for every Las Vegas quadrant showing job density and regional revenue concentration.
  • ▸Live 3-truck fleet status monitoring, emergency crew broadcasts, and 1-click RFC-4180 CSV Audit Exports stamped with Employee IDs (HH-EEID-001 through 007).
WORKSPACE 02 // RECEPTION & AI TELEPHONY DESKHH-EEID-002 (Front Desk & Custody)

Retell AI Voice Controls & 2-Person Bank Deposit Reconciliation

  • ▸Instant Retell AI Voice Receptionist mode switching between ACTIVE (24/7 AI answering), OVERFLOW (human-first, AI backup), and PAUSED.
  • ▸1-Tap Call Routing converting inbound call logs directly into the Estimator Calendar or Warranty Care route with automatic ZIP-to-quadrant geocoding.
  • ▸2-Person Cash & Check Bank Deposit Reconciliation: enforces financial custody separation—when an estimator collects cash or check in the field, Reception must verify the physical bank drop against online banking before depositPaid unlocks for installation.
WORKSPACE 03 // IN-PERSON ESTIMATOR SUITEHH-EEID-003 (Lead Estimator)

Live On-Site Quoting Engine & Smart 2-Step Install Slot Dispatcher

  • ▸Neat 2-hour daily route blocks (8:00 AM–5:30 PM) with 1-tap "Start Visit" arrival timestamping and duration-tracked "End Visit" logging.
  • ▸Live On-Site Quoting & Discount Engine calculating roofline footage, palm tree tiers, stake lights, discretionary discounts (5%–20% or Custom %), and exact-cent 50% deposit math.
  • ▸4-Path Walkthrough Outcome Engine (Agreed & Paid, Agreed – Pay Later, Thinking About It, Declined with mandatory objection logging) paired with a Smart Install Slot Dispatcher that recommends dates where a truck is already anchored in that quadrant.
WORKSPACE 04 // ANTI-ZIGZAG WARRANTY CARE ROUTEHH-EEID-004 (Dedicated Service Runner)

Autonomous Quadrant Clustering & Zero-Cash Rapid Resolution

  • ▸Automatically groups complimentary warranty repair requests into same-quadrant Morning (9 AM–12 PM) and Afternoon (2 PM–5 PM) loops radiating from 3030 Westwood Drive.
  • ▸Eliminates cross-valley driving for single bulb or timer replacements during peak December demand.
  • ▸Streamlined Zero-Cash ($0.00) field interface with 1-tap elapsed time logging (15m, 30m, 45m, 60m), mandatory resolution notes (e.g., "Replaced 3 C9 warm white bulbs + GFCI reset"), and 1-click multi-stop Google Maps navigation.
WORKSPACE 05 // FIELD CREWS & JANUARY TAKEDOWN HUBHH-EEID-005..007 (Trucks 1, 2 & 3)

3-Truck Quadrant Dispatch, Photo Proof Gate & Climate Vault Takedowns

  • ▸Decoupled fleet scheduling across Truck 1 (NW / Summerlin), Truck 2 (Henderson / Green Valley), and Truck 3 (SW / Enterprise), capped at a realistic maximum of 3 estate installations per truck per day.
  • ▸Dynamic Route Elasticity & Pull-Forward Handshake allowing crews finishing early to pull forward same-quadrant jobs afterReception phone confirmation and custom light stock verification.
  • ▸Mandatory wide-angle photo proof gate (or documented Supervisor Exception) required before unlocking INSTALL_COMPLETED, which automatically transitions the estate into the January Takedown & Climate Vault manifest (PENDING → SCHEDULED → COMPLETED) at 3030 Westwood Drive.
UNIFIED LEDGER // CLIENT DOSSIER & LIFETIME JOURNEYPermanent Record (#HL-CID-XXXX)

Multi-Season Estate Dossier & 5-Stage Visual Pipeline Stepper

  • ▸Every homeowner or commercial property is assigned a permanent Lifetime ID (#HL-CID-XXXX) tracking multi-season roofline specifications and storage bin locations.
  • ▸5-Stage Visual Pipeline Stepper tracking Lead Intake → Walkthrough & Quote → Deposit & Bank Verification → Installation & Photo Proof → January Takedown & Storage.
  • ▸Includes a high-resolution installation photo proof lightbox and a chronological multi-season audit ledger.
05 // ALGORITHMIC & SECURITY DEEP-DIVES

How Geographic Zoning & Custody Controls Work Under the Hood

Every architectural decision was anchored in physical Las Vegas geography, financial auditability, and zero-trust security boundaries.

SPOTLIGHT A // GEO-ROUTING ENGINE

Las Vegas Valley 4-Quadrant ZIP Clustering

Automatically resolves 5-digit ZIP codes into dedicated operational sectors radiating from 3030 Westwood Drive:

SUMMERLIN_NW (Truck 1 Anchor)
The Ridges, Red Rock, Queensridge, Centennial (89134, 89135, 89138, 89144...)
HENDERSON_GV (Truck 2 Anchor)
MacDonald Highlands, Ascaya, Anthem, Seven Hills, Lake Las Vegas (89012, 89052...)
SW_ENTERPRISE (Truck 3 Anchor)
Southern Highlands, Spanish Trail, Rhodes Ranch, Mountains Edge (89141, 89148...)
CENTRAL_NLV (HQ Radius Hub)
3030 Westwood Corridor, Scotch 80s, Las Vegas Country Club, Aliante
SPOTLIGHT B // FINANCIAL CUSTODY

2-Person Cash & Check Bank Reconciliation

High-value residential and commercial installs frequently involve on-site check or cash deposits. We eliminated custody ambiguity via a strict state machine:

STEP 1 // FIELD COLLECTION (WITH_VANESSA)

Estimator logs exact-cent 50% deposit collected on-site via Cash or Check. Job enters WITH_VANESSA custody state; installation scheduling remains locked.

STEP 2 // FRONT-DESK BANK DROP VERIFICATION

Receptionist (HH-EEID-002) reconciles the physical bank deposit slip against online banking records.

STEP 3 // DISPATCH UNLOCK (VERIFIED_IN_BANK)

Only after dual-employee verification does depositPaid unlock for Truck 1–3 installation dispatch, stamping both employee IDs to the audit log.

SPOTLIGHT C // ZERO-TRUST SECURITY

Web Crypto HMAC-SHA256 Edge Auth & Public Anonymity

Engineered for rapid field switching on iPads and mobile devices without compromising enterprise security:

  • Edge-Verified JWT SessionsZero-dependency Web Crypto API HMAC-SHA256 tokens stored in HttpOnly; SameSite=Lax cookies, verified inside Next.js Edge Middleware.
  • Public Employee AnonymityZero internal staff names are exposed on the public website—protecting key personnel from competitor poaching while maintaining full Employee ID (HH-EEID-001..007) accountability inside the private CRM.
  • Strict Search Engine IsolationEvery CRM route enforces X-Robots-Tag: noindex, nofollow and role-scoped API guards.
06 // THE 8-PHASE DELIVERY ROADMAP

How We Took Holiday Illumination From Legacy Static to Enterprise Grade

Executed across eight disciplined engineering sprints—from monorepo decomposition and luxury brand positioning to behavioral UX telemetry and Robert C. Martin Clean Code verification.

PHASE 01

Monorepo & Next.js 16 Migration

Replaced legacy static HTML with a modular npm workspaces monorepo (apps/web, apps/crm, test/) running Next.js 16 App Router, React 19, TypeScript 5, and Tailwind CSS v4.

PHASE 02

Midnight Luxe 60-30-10 Brand System

Crafted the nocturnal luxury visual language (#090D16 Obsidian, #D4AF37 Champagne Gold, #961C28 Velvet Crimson), 1998 heritage storytelling, and $750 minimum anchor.

PHASE 03

Haute Halloween & 20-Q Persona FAQ

Added the gateway October Halloween showcase and a 20-question technical FAQ addressing Spanish clay tile roofs, <5 PSI spider lifts, and nocturnal commercial installs.

PHASE 04

Geo-Smart Intake & Valley Zoning

Built the 3-step walkthrough wizard and Las Vegas ZIP-to-quadrant geocoding engine to eliminate cross-valley estimator driving.

PHASE 05

5-Role CRM & Edge JWT + PIN Auth

Engineered the 5 role-based workspaces protected by Web Crypto HMAC-SHA256 Edge JWT sessions and 4-digit PIN switching.

PHASE 06

2-Person Custody & Lifetime Ledger

Implemented 2-person bank deposit verification, 4-outcome estimator workflows, photo-proof installation gates, and January Climate Vault manifests.

PHASE 07

Empirical UX Audit & Design Spells

Resolved 19 behavioral UX findings (F01–F11, UX-01–UX-08), enforcing 44px Apple HIG touch targets, WCAG AAA contrast, and Weibull 8.0s hesitation telemetry.

PHASE 08

Clean Code Refactor & 107-Test Suite

Executed a Robert C. Martin Clean Code audit (R01–R10), decomposing monoliths into SRP domain modules backed by 107 zero-dependency automated tests.

07 // TECHNICAL VERIFICATION & QUALITY ASSURANCE

107 Automated Verification Assertions Across 4 Test Suites

Every routing rule, discount calculation, role permission guard, and WCAG contrast token is continuously verified via a zero-dependency Node.js native test runner suite (node --test).

Enterprise Architecture StackZero Build Errors
Framework & UI RuntimeNext.js 16.2+ (App Router), React 19.2, TypeScript 5
Styling & Design TokensTailwind CSS v4, Midnight Luxe 60-30-10 Token Architecture
Database & Realtime SyncSupabase Postgres + Realtime Channels + LocalStorage Fallback
Authentication & RBACWeb Crypto API HMAC-SHA256 Edge JWT + 4-Digit Role PINs
Voice AI & TelephonyRetell AI Voice Receptionist Webhook & Mode Controller
UX & Accessibility StandardWCAG AAA Contrast, 44×44px Apple HIG Touch Targets, Reduced Motion
test/web-smoke.test.mjsPASS
Public Luxury Website & SEO

Hero LCP priority, Day/Night slider keyboard a11y, Halloween pre-selection, 20 FAQs, JSON-LD LocalBusiness schema, and public employee anonymity.

test/crm-smoke.test.mjsPASS
5-Role CRM & State Machine

RBAC workspaces, 2-person bank custody verification, photo proof installation gates, and January Climate Vault takedown workflow.

test/crm-clean-code.test.mjsPASS
SRP Domain Engine Unit Tests

Exact-cent 50% deposit math, RFC-4180 CSV escaping, Las Vegas ZIP quadrant mapping, and multi-stop Google Maps URL generation.

test/ux-audit-fixes.test.mjsPASS
Empirical UX Behavioral Guards

Weibull 8.0s dwell-hesitation trigger, scroll-thrashing detection, 44px touch targets, and WCAG AAA contrast compliance.

READY TO ELIMINATE OPERATIONAL BOTTLENECKS?

Need a High-Converting Luxury Platform Paired with a Custom Operations CRM?

Whether you operate a multi-crew field service enterprise in the United States or a multi-property hospitality portfolio in East Africa, we engineer bespoke conversion websites, AI voice receptionists, and role-based dispatch consoles that turn operational chaos into measurable profit.

Official client domain cutover (www.holidayillumination.com) scheduled next week • Internal Operations CRM kept private by NDA & security policy

WhatsApp UsFree Audit