World Lens is a high-performance Flutter application designed for real-time global intelligence monitoring. It provides a spatial and analytical view of world events, country risks, and financial markets.
Visualize live global events on a high-fidelity 3D Earth using Globe.gl.
- Dynamic Markers: Real-time events are plotted geographically with pulsing animations.
- Category Filtering: Filter markers by Conflict, Disaster, Politics, Economy, Technology, and Energy.
- Spatial Interaction: Click any marker to instantly view the situation overview.
A proprietary data aggregation system that monitors critical global developments.
- Secure Integration: Sources are managed via encrypted environment variables to protect intelligence integrity.
- Unified "All" View: A combined feed to monitor all intelligence categories simultaneously.
- Resilient Delivery: Advanced retry logic with exponential backoff ensures data availability in high-stress environments.
Monitor the global financial pulse.
- Digital Assets: Real-time tracking for BTC, ETH, and other major cryptocurrencies via CoinGecko.
- Forex: Live currency exchange rates and market trends.
A distraction-free, voice-controlled news experience for users on the move.
- Voice Control (STT): Command the app by voice: "Read latest news", "What happened today?", or category-specific requests like "Give me Politics news".
- News Narration (TTS): Professional text-to-speech engine reads summaries aloud.
- Minimalist Interface: High-contrast, safe-driving UI with ambient visual feedback.
- Guided Onboarding: Voice-ready tutorial to get started safely.
World Lens is engineered for production-grade performance on mobile hardware. It is currently in Active Development (v1.0.0-alpha).
- GPU Isolation: Uses
RepaintBoundaryto isolate expensive glassmorphism and 3D rendering cycles, reducing overhead during scrolling. - Main-Thread Efficiency: Critical data processing (Earthquake markers, Financial metrics) is pre-computed and memoized to prevent frame drops.
- Persistent Caching: Powered by Hive for ultra-fast, local storage of news intelligence and country data.
The project follows Clean Architecture principles to ensure scalability:
lib/core/: Shared utilities, API clients, and theme constants.lib/features/: Feature-modularized logic:earth/: 3D Globe and disaster monitoring.news/: Global intelligence feed and persistence.country/: National risk profiling.driving/: Voice-controlled HMI.finance/: Market sentiment tracking.
- Framework: Flutter (Dart)
- State Management: BLoC (Business Logic Component)
- 3D Engine: Three.js / Globe.gl (integrated via
webview_flutter) - Voice Services: Speech-to-Text (STT) & Text-to-Speech (TTS)
- Networking: Dio with Clean Architecture principles and retry interceptors.
- Dependency Injection: GetIt
- Data Modeling: Freezed & JSON Serializable
- Navigation: GoRouter
The project follows Clean Architecture principles to ensure scalability and maintainability:
- Core: Shared utilities, API clients, and theme constants.
- Features: Modular structure (Earth, News, Country, Finance) each containing:
- Domain: Entities and Repository interfaces.
- Data: Repository implementations and Data sources.
- Presentation: UI Widgets, Pages, and BLoC logic.
- Flutter SDK (^3.12.0)
- Dart SDK
- Environment Configuration: A
.envfile with valid intelligence source endpoints is required.
- Clone the repository.
- Configure your intelligence endpoints in a
.envfile at the root. - Install dependencies:
flutter pub get
- Generate data models:
flutter pub run build_runner build --delete-conflicting-outputs
- Run the app:
flutter run
Future enhancements planned for World Lens:
- Real-time Satellite Imagery: Integration of live satellite tiles for enhanced 3D visualization.
- AI-Powered Event Prediction: Machine learning models to forecast potential regional escalations.
- Expanded Intelligence Sources: Adding more regional OSINT feeds for deeper local insights.
- Community Reporting: Allow users to submit verified local event data.
Contributions are welcome! Whether it's reporting a bug, suggesting a feature, or submitting a pull request, your help is appreciated.
This project is licensed under a Proprietary Commercial License. All commercial rights and income belong exclusively to the author. See the LICENSE file for details.
World Lens aggregates open-source intelligence from respected global publishers. We acknowledge the following sources for their data feeds:
- News Content: Proprietary aggregation of global RSS feeds including BBC News and Fox News.
- Geographic Data: Powered by Globe.gl and Three.js.
- Market Data: Real-time financial insights via CoinGecko and Open Exchange Rates.
- Environmental Monitoring: Earthquake data provided by the USGS.
World Lens — Real-time awareness for a complex world.