Skip to content

pri682/Lucidia

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

7 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸŒ™ Lucidia

A Speculative Brain-Computer Interface (BCI) App for Sensory Dream Interventions

FigBuild 2026 Hackathon Submission: Sensory Experience Tool

Lucidia is a revolutionary, Apple-inspired mobile application that acts as the control center for next-generation Brain-Computer Interfaces (BCI) like NeuroLink and Cortical Sync. It goes beyond standard sleep tracking by bridging the gap between the conscious and unconscious mind. Lucidia tracks, visualizes, and directly manipulates the user's sensory experiences while they sleepβ€”specifically targeting dreams to treat phobias, resolve trauma, and optimize cognitive restoration through an advanced 8-sense neural mapping system.


🎯 The Challenge & Our Vision

This project answers the challenge to "design a tool that tracks, measures, visualizes or quantifies an aspect of human sensory experience, and provides the ability to detect, enhance, or manipulate those same sensory inputs."

Lucidia unlocks the subconscious sensory landscape. By recording and decoding the multisensory experiences of dreams across all 8 human senses (visual, auditory, tactile, olfactory, gustatory, proprioception, interoception, vestibular, and chronoception), Lucidia allows users to perceive the unremembered data of their own sleeping minds, and safely manipulate it to improve their waking life.


πŸ‘₯ Who is this for?

Lucidia is designed for:

  • Individuals combating phobias, anxiety, or PTSD who want a safe, controlled environment (their dreams) for exposure therapy.
  • People with sleep disorders or recurring nightmares seeking active intervention rather than passive tracking.
  • Bio-hackers and wellness enthusiasts aiming to optimize their cognitive health, memory consolidation, and emotional regulation through lucid dream induction and sleep cycle optimization.
  • Researchers and early adopters exploring the frontiers of neural intervention and consciousness manipulation.

πŸ‘οΈ What can they perceive now that they couldn't before?

The Subconscious Sensory Landscape (The Hidden Dimensions of the Dreaming Mind):

Humans experience rich visual, tactile, and emotional stimuli while dreaming, but 90% of it is forgotten upon waking. Lucidia translates the brain's neural firing patterns during REM sleep into quantifiable data across 8 distinct sensory channels:

  • Visual - Dream imagery intensity and color vibrancy
  • Auditory - Sound frequencies and voice recognition
  • Tactile - Touch, pressure, and texture sensations
  • Olfactory - Scent detection and emotional triggers
  • Vestibular - Spatial orientation, flying, falling sensations
  • Proprioception - Body awareness and movement
  • Interoception - Internal bodily sensations (heartbeat, breathing, temperature)
  • Chronoception - Perception of time dilation and compression

Users can now "see" and "feel" what their brain was experiencing overnight. More importantly, they gain Lucidity Awarenessβ€”the ability to perceive and manipulate their dream state in real-time through BCI-triggered sensory overrides (e.g., injecting a calming olfactory sensation of lavender when the brain detects a stress-inducing visual in a nightmare).


🧠 Target Wellness Goal & Behavioral Change

Target Wellness Dimension: Mental and Emotional Wellbeing.

Goal: To eliminate irrational phobias, reduce nocturnal anxiety, and improve overall psychological resilience.

By using targeted Neural Interventions, Lucidia helps the brain unlearn fear responses. The behavioral change occurs as the user experiences reduced physiological stress (lower waking cortisol, reduced panic attacks) when confronting their fears in the real world, having already conquered them in the simulated sandbox of their dreams.


πŸ“± How does the tool work in everyday life? (3 Use Cases)

  1. The Phobia Treatment Protocol (Exposure Therapy): Story: Sarah has a severe fear of spiders (arachnophobia). During a routine dream analysis, Lucidia detects recurring arachnid-like visual patterns causing heart-rate spikes. The app suggests a "Sensory Override." Sarah manually approves the intervention. The next night, when the BCI detects the nightmare forming, it overrides the tactile and visual processing centers, turning the terrifying sensation into a soft, glowing, harmless orb accompanied by a calming tactile warmth, slowly rewiring her fear response.

  2. Nightmare Prevention & Sleep Cycle Optimization: Story: Mark suffers from stress-induced nightmares that ruin his sleep architecture. Lucidia maps his brain waves and detects the onset of a night terror. Instantly, the Neural Intervention Mode activates, gently manipulating the auditory sensory inputs within the dream (playing a familiar, soothing song directly into his auditory cortex) to steer the dream away from trauma without waking him up.

  3. Dream Decoding & Emotional Reflection: Story: Elena wakes up feeling anxious but doesn't know why. She opens the DreamBank in Lucidia. The app has reconstructed the emotional and sensory themes of her night, showing that she experienced high levels of spatial disorientation (vestibular sense) and cold tactile sensations. She reviews the AI-powered insights, realizes it correlates with her recent career change anxiety, and uses the app's BreathingScreen to ground herself.


πŸ“Š How do users manage the new information?

Lucidia features a strictly organized, Apple-inspired interface to prevent information overload:

  • The Dashboard (Home & Stats): High-level daily sleep scores, sleep architecture graphs, and recovery metrics. Information is surfaced gracefully, prioritizing what matters today.
  • DreamBank & Sensory Analysis: A dedicated space where dreams are decoded into readable narratives and sensory data (Visual, Tactile, Olfactory, Auditory). Users can review the sensory intensity of their dreams via clean, interactive visualizer components.
  • Neural Intervention Modal: The core interaction for sensory manipulation. Users are presented with AI-suggested "Phobia Targets" and "Sensory Overrides." Crucially, users must manually approve any intervention. They build a personalized "playlist" of sensory manipulations that the BCI will execute during specific REM stages.

πŸ›‘οΈ What safeguards are in place?

Manipulating the subconscious mind carries profound ethical and psychological risks. Lucidia implements strict safeguards:

  1. Strict Manual Consent (The "Opt-In" Rule): The BCI will never alter a dream or apply a sensory override without explicit, prior manual approval from the user while they are awake and conscious.
  2. On-Device Processing (Privacy): Neural data is the most intimate data imaginable. All cognitive analysis and decoding happens strictly on-device using advanced post-quantum cryptography. No dream data is ever sent to the cloud.
  3. Emergency Wake Protocol (Fail-safes): If the BCI detects extreme physiological distress (e.g., heart rate exceeding safe thresholds) that fails to respond to soothing sensory overrides, the hardware initiates a gentle, escalating tactile and auditory wake sequence to pull the user out of the nightmare safely.
  4. Reality Anchoring: To prevent dissociation, users must complete a quick reality-check calibration exercise on their device upon waking, confirming they are fully conscious and differentiating the dream memories from reality.

πŸš€ Key Features Built

🎨 Core Navigation & Interface

  • Home Dashboard - Daily sleep score with animated gradient orb, quick stats, and BCI connection status
  • Bottom Tab Navigation - Smooth transitions between Home, DreamBank, Stats, Sounds, and Settings
  • Dark/Light Mode Toggle - Seamless theme switching with persistent preferences
  • Mini Player - Persistent audio player for ambient sounds and neural playback across all screens

🧠 Advanced BCI Components

Sensory Topology Radar Chart

  • 8-dimensional radar visualization mapping all human senses during REM sleep
  • Interactive tooltips with real-time sensory intensity data
  • Visual, Auditory, Tactile, Olfactory, Vestibular, Proprioception, Interoception, and Chronoception tracking
  • Smooth animations with pulsing glow effects

Neural Playback Scrubber

  • Advanced video-editing-style timeline for reviewing recorded dreams
  • Multi-track waveform visualization for different sensory channels
  • Anomaly detection markers highlighting significant sensory events
  • Playback controls with frame-by-frame scrubbing
  • Automated AI annotations on the timeline

Sensory Override Protocol Screen

  • Configuration interface for neural interventions during sleep
  • Glassmorphic "Chronoception Anchor" settings card
  • Interactive toggles for enabling/disabling specific sensory overrides
  • Progressive disclosure of intervention parameters
  • Security warnings and consent checkpoints

Slide-to-Confirm Component

  • Reusable security component for authorizing neural write-access
  • Haptic-style feedback with smooth drag interactions
  • Success state animations with gradient effects
  • Used throughout the app for critical actions

πŸ“Š Sleep Analysis & Insights

Sleep Synthesis Screen (3 Tabs)

  1. AI Overview Tab

    • Comprehensive dream analysis with category classification
    • 10 dream categories (Passion & Aspirations, Joy & Happiness, Processing & Adaptation, Health Alerts, Romance & Connection, etc.)
    • Coherence, anxiety, and lucidity metrics
    • Symbol, emotion, and people tracking
    • Personal & relational advice powered by AI
    • BCI daily experiences context correlation
  2. Sleep Stats Tab

    • Time summary with Day/Week/Month filters
    • Total sleep time and deep sleep breakdown
    • Sleep quality graphs and trend analysis
    • Sleep stage detail bars
    • Health insights cards with actionable recommendations
    • Sleep timeline charts
    • Sleep recommendations based on patterns
  3. Sensory Report Tab ⭐ NEW

    • Morning Sleep & Sensory Report Card
      • Circular progress ring showing interoceptive load (78%)
      • High-polish animated gradient stroke
      • Center summary with load assessment
      • 3 minimalist pills showing dominant senses (Vestibular/Flying, Chronoception/Time Dilation, Visual/Vivid)
      • AI insight with morning dissociation warning
      • "Run 60-Second Reality Anchoring Exercise" CTA button
    • 8-Sense Intensity Map
      • Detailed horizontal bar chart for all 8 senses
      • Color-coded progress bars with shimmer animations
      • Percentage values for each sensory channel
    • Sensory Events & Interventions
      • Real-time anomaly detection (time dilation, vestibular coherence, temperature spikes)
      • Color-coded warning/success/info cards
      • Shows which BCI interventions were deployed

πŸŒ™ DreamBank Features

  • Interactive Calendar Grid - Monthly view of dreams with color-coded emotion gradients
  • Dream Orb Visualization - Tap any day to see detailed dream analysis
  • Expandable Analysis Cards - Coherence scores, anxiety levels, lucidity tracking
  • People, Symbols & Emotions - AI-extracted dream elements
  • Sensory Discomfort Detection - Automatic phobia identification with intervention suggestions
  • Add to Intervention Targets - One-tap to queue sensory overrides
  • View Complete Sleep Synthesis - Navigate to full sleep analysis from dream preview
  • Navigate to Sensory Topology - Deep dive into sensory data from any dream

🎯 Neural Intervention System

  • Phobia Target Management - Build a personalized intervention playlist
  • Sensory Override Controls - Visual, Tactile, Olfactory manipulation settings
  • Manual Consent Flow - Strict opt-in with slide-to-authorize security
  • Real-time Intervention Status - Shows active overrides during sleep
  • Emergency Wake Protocol - Automatic safety mechanisms

🎡 Ambient Sounds & Meditation

  • 6 Curated Soundscapes - Ocean Waves, Forest Rain, White Noise, Campfire, Thunder, Wind Chimes
  • Breathing Exercises - Box Breathing, 4-7-8 Technique, Resonant Breathing
  • Timer Controls - Custom durations for meditation sessions
  • Background Playback - Continues while navigating the app

βš™οΈ Settings & Customization

  • BCI Connection Status - Battery level, signal strength, firmware info
  • Device Pairing Flow - Animated scanning and syncing with NeuroLink hardware
  • Privacy Controls - On-device processing, data encryption settings
  • Notification Preferences - Dream analysis alerts, intervention confirmations
  • Account Management - User profile and preferences

🎨 Design & Animations

  • Clinical Apple Health Aesthetic - High-end, medical-grade UI with consumer polish
  • Sci-Fi Telemetry Elements - Bioluminescent purples, electric blues, space blacks
  • Glassmorphic Effects - Frosted glass cards with subtle gradients
  • Smooth Framer Motion Animations - Page transitions, card reveals, progress indicators
  • Responsive Mobile-First - Optimized for iOS/Android mobile viewports
  • Dark Mode Mastery - Deep blacks with glowing accent colors

πŸ› οΈ Technical Stack

  • React 18 - Modern component architecture with hooks
  • TypeScript - Type-safe development
  • React Router - Data mode routing for multi-page navigation
  • Tailwind CSS v4 - Utility-first styling with custom design tokens
  • Framer Motion - High-performance hardware-accelerated animations
  • Lucide React - Beautiful icon system
  • Recharts - Data visualization for sleep graphs
  • Context API - Global theme and state management

🎯 User Experience Flow

  1. Wake Up β†’ Open Lucidia to see your Sleep & Sensory Report
  2. Review Morning Briefing β†’ Check interoceptive load and dominant senses
  3. Read AI Insights β†’ Understand what your dreams mean for your waking state
  4. Tap Dream Orb in DreamBank β†’ Explore detailed analysis of last night's dreams
  5. View Sensory Topology β†’ See your 8-sense radar chart
  6. Review Anomalies β†’ Check what interventions were deployed
  7. Manage Interventions β†’ Add new phobia targets or adjust sensory overrides
  8. Run Reality Anchoring β†’ Complete grounding exercise if feeling dissociated
  9. Set Tonight's Protocol β†’ Configure which interventions to run
  10. Sleep & Let BCI Work β†’ Wake up with improved mental health

πŸ”’ Privacy & Ethics

Lucidia takes neural privacy seriously:

  • Zero Cloud Storage - All dream data stays on-device
  • Post-Quantum Encryption - Military-grade protection for neural recordings
  • Explicit Consent Required - No intervention runs without slide-to-authorize
  • Transparent AI - All insights are explainable and traceable
  • Medical-Grade Safety - Emergency wake protocols prevent harm
  • Reality Anchoring Mandatory - Prevents dissociation upon waking

πŸš€ Getting Started

# Install dependencies
npm install

# Start development server
npm run dev

# Build for production
npm run build

🌟 Future Roadmap

  • Multi-Night Pattern Recognition - Identify recurring dream themes over weeks
  • Shared Dream Analysis - Compare sensory profiles with sleep partners
  • Third-Party BCI Support - Expand beyond NeuroLink to other neural interfaces
  • Dream Journaling with Voice - Speak your dreams upon waking for AI transcription
  • Lucid Dream Induction Training - Progressive exercises to increase lucidity scores
  • Therapist Integration - Export anonymized reports for clinical use

πŸ“„ License

This is a speculative design project created for a hackathon. The technology depicted (neural dream manipulation, sensory overrides) does not currently exist but represents a possible future direction for BCI applications.


Built with πŸ’œ for the future of consciousness exploration

About

Lucidia is a revolutionary, Apple-inspired mobile application that acts as the control center for next-generation Brain-Computer Interfaces (BCI) like NeuroLink and Cortical Sync. It goes beyond standard sleep tracking by bridging the gap between the conscious and unconscious mind.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages