SIGINT

Real-time OSINT dashboard with live aircraft, vessel, seismic, fire, weather, and event tracking on an interactive globe. Built with Bun, React 19, and a custom Canvas 2D + Web Worker rendering engine. Installable as a PWA.

Screenshot

Table of Contents

• SIGINT
  • Screenshot
  • Table of Contents
  • Features
    • Live Data
    • Intelligence
    • Visualization
    • Platform
  • Installation
  • Quick Start
  • Environment Variables
  • Data Sources
  • Testing
  • Deployment
    • Development
    • Production
    • Production with TLS
    • Heroku
    • Cleanup
  • PWA
  • Documentation
  • License
  • Author

Features

Live Data

• Aircraft tracking (adsb.fi)
• AIS vessel tracking (aisstream.io)
• Seismic monitoring (USGS)
• Fire hotspot detection (NASA FIRMS)
• Severe weather alerts (NOAA)
• GDELT event intelligence
• RSS news aggregation (6 world sources)
• HLS video feeds (iptv-org)

Intelligence

• Correlation engine with cross-source products and scored alerts
• Military aircraft classification
• Watch mode (automated globe tour)
• Entity dossier with photos, routes, metadata

Visualization

• Globe and flat map projections
• Multi-pane resizable layout with drag, minimize, presets
• Camera lock-on, isolation modes, trail rendering
• Global search with live globe filtering
• Virtual-scrolling data table
• Live ticker feed

Platform

• Dark/light themes
• Mobile responsive with separate layout presets
• PWA with offline support, update notifications, pull-to-refresh
• Offline indicator with connectivity detection
• Cookie-authenticated API (HMAC-SHA256, HttpOnly)

Installation

git clone https://github.com/iitoneloc/sigint.git
cd sigint
bun install

Create a .env file in the project root with at minimum:

SIGINT_SERVER_SECRET=<output of openssl rand -hex 32>

Optionally add keys for ship and fire data:

AISSTREAM_API_KEY=<your aisstream.io key>
FIRMS_MAP_KEY=<your NASA FIRMS key>

Quick Start

See Deployment for dev, production, and Heroku options.

Environment Variables

Data Sources

Testing

bun test            # run all tests
bun test --watch    # watch mode
bun run docker:test # run in Docker

Deployment

Development

bun run docker:dev:up          # https://localhost (self-signed cert)
bun run docker:dev:down        # stop

Dev-only fixture overrides

Two env vars short-circuit live data fetches in development so you can work against a known frozen state. Both are gated on NODE_ENV !== "production" and ignored in production builds.

Labels match /^[a-z0-9-]+$/ (OWASP A01 — strict allowlist before any file lookup) and resolve to tests/fixtures/<source>/<label>.json. Invalid labels throw at startup; missing files throw with the resolved path. To use:

CYCLONES_FIXTURE=multi-storm bun run dev
AIRCRAFT_FIXTURE=conus-snapshot bun run dev

Or via Docker Compose (docker-compose.dev.yml passes both through):

CYCLONES_FIXTURE=single-cat5 bun run docker:dev:up

Production

bun run docker:prod:up         # http://localhost:5500
bun run docker:prod:down       # stop

Production with TLS

DOMAIN=sigint.example.com bun run docker:prod:tls:up
bun run docker:prod:tls:down   # stop

Heroku

git push heroku main

Cleanup

bun run docker:clean:all       # remove containers, volumes, images

PWA

SIGINT is installable as a Progressive Web App. After visiting the deployed app:

• Desktop (Chrome/Edge): Click the install icon in the address bar
• iOS Safari: Share > Add to Home Screen
• Android Chrome: Menu > Add to Home Screen

The service worker caches the app shell for offline boot. Live data loads from IndexedDB when offline. An offline indicator bar appears when connectivity is lost, with a RETRY button and pull-to-refresh on touch devices. When an update is available, a banner prompts the user to reload — no silent mid-session code swaps.

Documentation

Full technical docs in docs/ covering architecture, data flow, feature system, pane system, rendering, caching, search, and constraints.

License

Dual-licensed:

• Non-commercial free under the SIGINT Non-Commercial License
• Commercial contact the author for terms

Author

Anthony Tropeano