Smart-Innovations-Ghana/MineralMonitor

Real-time intelligence dashboard. AI-powered news aggregation, geopolitical monitoring, and infrastructure tracking in a unified situational awareness interface # MineralMonitor **Real-time intelligence dashboard** — AI-powered GIS aggregation, geopolitical monitoring, and mineral tracking in a unified situational awareness interface. --- ## What It Does - **Real-time data aggregation** across 30+ external data sources - **Dual map engine** — 3D globe (globe.gl) and WebGL flat map (deck.gl) with multiple data layers - **Cross-stream correlation** — monitoring for signals across multiple intelligence categories - **AI-powered synthesis** — aggregated intelligence briefs and analysis - **Finance & commodity tracking** — market monitoring and indicators - **Local AI support** — run with Ollama, no API keys required - **Multi-variant support** — 5 site variants from a single codebase - **Native desktop app** (Tauri 2) for macOS, Windows, and Linux - **Multi-language support** with RTL support --- ## Quick Start ```bash git clone github.com cd MineralMonitor npm install npm run dev ``` Open localhost:5173. No environment variables required for basic operation. For variant-specific development: ```bash npm run dev:tech # Tech variant npm run dev:finance # Finance variant npm run dev:commodity # Commodity variant npm run dev:happy # Happy variant ``` --- ## Development ```bash npm run typecheck # Type checking npm run typecheck:api # API layer type checking npm run test:data # Run unit/integration tests npm run test:sidecar # Run sidecar tests npm run test:e2e # Run Playwright E2E tests npm run build:full # Production build make generate # Regenerate proto stubs and API specs ``` --- ## Tech Stack | Category | Technologies | |----------|-------------| | **Frontend** | TypeScript, Vite, Preact, globe.gl + Three.js, deck.gl + MapLibre GL | | **Desktop** | Tauri 2 (Rust) with Node.js sidecar | | **AI/ML** | Ollama / Groq / OpenRouter, Transformers.js (browser-side) | | **API Contracts** | Protocol Buff …