neom_states

Frequency state experience system for Cyberneom within the Open Neom ecosystem.

neom_states delivers binaural beat and frequency-based meditation/focus experiences with real-time audio synthesis, multi-phase timing, session tracking, and Pomodoro integration. Each state is a shareable deep link (/x/{stateId}).

Features

Frequency-based states with customizable binaural beat parameters
Multi-phase experiences with evolving audio and visual parameters
Real-time audio synthesis (mobile PCM + web AudioContext)
Pomodoro timer with work/break phases
Session history tracking (Hive local persistence)
Firebase analytics for session metrics
Achievement tracking
State catalog browser
Recommendation engine for suggested states
Shareable standalone deep links (/x/{stateId})
PRO/free tier differentiation
Multi-language support (ES, EN, FR, DE)

Architecture

lib/
  data/
    implementations/    # Platform-specific audio (mobile IO, web JS, stub)
    services/           # Session history, analytics, achievements, recommendations, presence, limiter
    translations/       # 4-language support
    state_catalog.dart  # Central frequency state definitions
  domain/
    models/             # FrequencyState, FrequencyPhase, Pomodoro config, session records
    use_cases/          # Audio service interface
  ui/
    widgets/            # State card, room wrapper
    state_experience_screen.dart   # Main immersive view
    state_experience_controller.dart
    state_catalog_page.dart        # State browser
    session_history_page.dart      # Session history viewer
  neom_states.dart
  neom_states_routes.dart

Dependencies

neom_core — Core services and Firestore utilities
neom_commons — Shared UI components and themes
Hive for local session persistence
Platform audio (PCM on mobile, AudioContext on web)

License

Apache License, Version 2.0. See LICENSE file for details.

neom_states

Features

Architecture

Dependencies

License

Libraries

neom_states package