neom_frequencies

Frequency Management module for the Open Neom ecosystem.

neom_frequencies is a specialized module dedicated to managing and displaying detailed frequency information. It serves as a complementary component to neom_generator, focusing on the visualization, organization, and interaction with frequency data. This module integrates seamlessly with the Open Neom platform, adhering to its modular architecture and Clean Architecture principles.

Features & Responsibilities

Frequency Visualization

Detailed displays of frequency data
Waveforms and spectrograms
Visual representations for user understanding

Frequency Organization

Categorize and tag frequency presets
Favorite frequency management
Easy access and retrieval

Interactive Controls

Intuitive UI elements for adjusting parameters
Amplitude, duration, and modulation controls
Real-time parameter updates

Integration with neom_generator

Seamless connection with neom_generator module
Fetch and display real-time frequency data
"Neom Chamber" integration

User Customization

Save personalized frequency settings
Create custom frequency profiles
Use cases: meditation, focus, relaxation

Data Persistence

Local storage of frequency presets
Configuration retention across sessions
Firebase sync for cloud backup

Architecture

lib/
├── frequency_routes.dart
├── ui/
│   ├── frequency_controller.dart
│   ├── frequency_page.dart
│   ├── root_frequencies_page.dart
│   └── widgets/
│       └── frequency_widgets.dart
├── utils/
│   └── constants/
│       └── frequency_translation_constants.dart
└── neom_frequencies.dart

Dependencies

dependencies:
  neom_core: ^2.0.0       # Core services and models
  neom_commons: ^2.0.0    # Shared UI components
  sint: ^1.0.0            # State management (SINT framework)
  animated_text_kit: ^4.2.3  # Text animations

Usage

Displaying Frequency Selection Page

import 'package:neom_frequencies/ui/frequency_page.dart';

class MyFrequencyView extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: FrequencyPage(), // Displays the frequency selection
    );
  }
}

Accessing Favorite Frequencies

import 'package:neom_frequencies/ui/root_frequencies_page.dart';

// Navigate to user's favorite frequencies
Sint.toNamed(AppRouteConstants.frequencyFav);

Registering Routes

import 'package:neom_frequencies/frequency_routes.dart';

// Add to your app routes
final routes = [
  ...FrequencyRoutes.routes,
  // other routes
];

Frequency Data Model

Each frequency includes:

id: Unique identifier
name: Frequency name
frequency: Value in Hz
description: Detailed description
isFav: User favorite status
isMain: Primary frequency flag

ROADMAP 2026

Q1 2026 - Enhanced Visualization

Real-time waveform display
Spectrogram visualization
Frequency comparison view
Custom color themes for frequencies

Q2 2026 - Advanced Profiles

Multiple frequency profile presets
Profile sharing between users
Import/export frequency configurations
Scheduled frequency sessions

Q3 2026 - Audio Integration

Direct audio playback integration
Binaural beat generation
Isochronic tone support
Background frequency playback

Q4 2026 - Analytics & Insights

Frequency usage statistics
Session duration tracking
Mood/effect correlation analysis
Personalized frequency recommendations

State Management

neom_frequencies uses the SINT framework (GetX replacement) for:

Reactive state with Rx types
Controller lifecycle management
Dependency injection
Route management

Contributing

We welcome contributions! Whether you're fixing bugs, improving documentation, or adding new features related to frequency visualization and management, your help is appreciated.

License

This project is licensed under the Apache License, Version 2.0, January 2004. See the LICENSE file for details.