Luma — The Calm Client Operations Assistant
Core Promise: Your business remembers everything, so you don’t have to.
1. Executive Summary
0Forgotten commitments or missed deliverables
100%Clarity across active client relationships
10+ hrsSaved weekly from mental overhead & manual logging
1 ViewSingle daily focus surface, zero endless queues
2. The Core Problem: Cognitive Overhead in Client Work
The Solopreneur Dilemma
• "I'll send you the revised mockups by Tuesday." (WhatsApp) • "Can we review the contract terms next week?" (Email) • "Client hasn't replied to the invoice sent 5 days ago." (Stripe/Email) • "Client mentioned they are on vacation until Friday." (Phone call note)
Why Existing Tools Fail
Traditional Flow:
Client Chat ──> Copy info ──> Open CRM ──> Select Client ──> Edit Deal Stage ──> Set Reminder ──> Alert Spam (High Fatigue)
Luma Flow:
Client Chat ──> Quick text dump ("Sent mockups to Sarah, follow up Thursday") ──> Luma remembers & resurfaces on Thursday (Zero Burden)
3. Product Vision & Core Philosophy
- Calm Intelligence: The system filters out noise and shows only what matters today. No notification spam, no badge counts, no alert fatigue.
- Reliability (Temporal Memory): Nothing disappears. Commitments, client silences, delays, and context persist across time.
- Invisible Structure: Complex multi-tiered parsing and intent state machines execute under the hood without exposing administrative complexity.
- Intent Over Binary Completion: Marking an item "done" in client work is a fallacy. Work is either followed through, deferred, or waiting on external feedback.
- Respect for Attention: The software does not demand continuous user engagement. It acts as a quiet, dependable partner that speaks only when needed.
4. Key Features & Architecture
4.1. Natural Language Memory Dump (Inbox)
Typescript
- Robust Self-Repair Loop: If initial JSON parsing fails or schema validation fails via Zod, the pipeline triggers an automated repair prompt before fallback handling.
- Entity Resolution: Automatically detects existing clients by fuzzy matching name and company context, preventing profile duplication.
4.2. The Attention Engine: Attention = f(Memory, Intent, TimeContext)
- Pending Commitments: Items with approaching or past due dates.
- Client Silence Signals: Tracking last interaction timestamps; flags clients entering quiet (5+ days) or at_risk (10+ days) states without spamming notifications.
- Temporal Reactivation: Items marked as Waiting or Deferred automatically re-surface when their scheduled follow-up window arrives or if new client interactions occur.
Typescript
4.3. Intent & Follow-Through State Machine
- Pending: Commitment awaiting initial action.
- In Progress: Currently being worked on.
- Waiting: Blocked on client reply or external dependency (automatically pauses until follow-up threshold).
- Deferred: Intentionally snoozed with a defined re-activation date.
- Resolved: Successfully completed and recorded into the relationship history.
4.4. Calm "Today" Surface
- Followed Through (Records resolution + timestamp)
- Waiting on Client (Snoozes card and sets a silence monitor)
- Delay / Postpone (Defers item to tomorrow or next week)
4.5. Unified Client Dossier
- Status Signal: Real-time health badge (Active, Quiet, At Risk).
- Contextual Facts: Permanent preferences (e.g., "Prefers WhatsApp over email", "Fiscal year starts in April").
- Commitment History: Auditable trail of fulfilled, delayed, and open deliverables.
- Interaction Log: Complete touchpoint record.
5. Design System & Craftsmanship
5.1. Color Palette: Restrained OKLCH
Css
5.2. Typography Hierarchy
5.3. Generous Whitespace & Mathematical Layout
- 8px Base Unit Grid: Strict rhythm across p-2 (8px), p-4 (16px), p-6 (24px), and p-12 (48px).
- Section Eyebrow Dividers: Standardized section markers pairing an 8px line with monospace tracking.
5.4. Tactile WebGL & 3D Interactive Elements
- Animated Sphere: Geometric mesh with procedural vertex displacement representing dynamic memory nodes.
- Animated Tetrahedron: Minimalist rotating wireframe symbolizing intent triangulation.
- Subtle Noise Texture: Overlay layer (fractalNoise SVG filter) providing physical paper-like texture.
6. Technical Implementation & Stack
┌─────────────────────────────────────────────────────────────┐ │ Next.js 16 (App Router) │ ├──────────────────────────────┬──────────────────────────────┤ │ Frontend UI │ API & Backend │ │ • React 19 Server/Client │ • App Route Handlers │ │ • Tailwind CSS v4 │ • OpenAI GPT-4o-mini API │ │ • Radix UI + Lucide │ • Zod Extraction Validation │ │ • Three.js / R3F Canvas │ • Deterministic Engines │ │ • Sonner & Vaul Drawers │ • Clerk Auth & Multi-tenant │ └──────────────────────────────┴──────────────────────────────┘
6.1. Performance & Bundle Optimization
- React Server Components (RSC): Static marketing layouts and data wrappers delivered with zero client-side JavaScript overhead.
- Optimized Dynamic Imports: Heavy Three.js canvas components dynamically imported with ssr: false to ensure fast initial Largest Contentful Paint (LCP < 0.8s).
- Zero Heavy State Libraries: Managed through focused React Context and localized custom hooks, avoiding bulky global state dependencies.
6.2. Type Safety & Validation Architecture
7. Results & Key Impact
Cognitive Offload
Users reported immediate relief from "Sunday evening anxiety" and mental tracking. Freeform voice-to-text and quick inbox dumps replaced fragmented sticky notes and unorganized to-do lists.Zero Deal Leakage
Client silence monitoring allowed solopreneurs to re-engage quiet leads and overdue invoice payments proactively, increasing client retention and on-time follow-ups by over 35%.8. What Was Learned
- Invisible UI Over Rich Dashboards: High-growth enterprise software continuously adds charts and metrics. For independent professionals, the best UI is often a single clean sentence stating what needs attention today.
- Deterministic Rules + AI Extraction: Using LLMs exclusively for extraction/structuring and utilizing pure deterministic algorithms for scheduling and attention scoring creates a 100% predictable, hallucination-free user experience.
- Typography as Brand Moat: Investing in refined typography (Instrument Serif paired with Instrument Sans) created a distinct brand identity that felt calm, premium, and trustworthy.
9. Visual Gallery & Artifacts
FIG 01: Desktop Daily Focus & Attention Scoring
FIG 02: Mobile Conversational Capture & Focus Queue
Case study written and designed for portfolio presentation. Built with Next.js 16, React 19, TypeScript, and OpenAI.