neom_states 1.0.1

Frequency state experience system for Cyberneom. Standalone /x/{stateId} links.

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.