Real-time global monitoring dashboard with a composable applet architecture.

Netr is a high-performance, extensible intelligence dashboard that aggregates live data from dozens of open sources — earthquakes, flights, news, markets, cyber threats, weather, infrastructure status, and more — into a single customizable board.

Originally inspired by koala73/worldmonitor. Netr is a ground-up rewrite that replaces the monolithic SPA with a modular applet-based architecture, delivering dramatically better performance and extensibility.

The Netr SDK is a batteries-included toolkit for building applets in minutes, not hours:

Hooks:

• usePolling(fetcher, interval) — auto-cleaning interval fetch with loading/error states
• useMapLayer(services, id, layerFn) — reactive Deck.gl layer lifecycle on the shared map
• useEventBus(services, channel, handler) — typed pub/sub with auto-unsubscribe
• useAppletState(props, defaults) — persist applet config to IndexedDB across reloads
• useFilter(items, filterFn) — reactive list filtering

Components:

• AppletShell — standard frame with header, toolbar slot, and scrollable body
• DataList — virtualized list with built-in loading, error, and empty states
• StatGrid — numeric KPI grid
• FilterBar — pill-based category filter
• Badge, Sparkline, TimeAgo, LoadingState, ErrorState

Layer Factories:

• createScatterLayer(), createPathLayer(), createArcLayer(), createGeoJsonLayer()
• Pre-configured with dark-theme defaults, just pass your data

Utilities:

• timeAgo, formatNumber, formatAltitude, formatSpeed, colorScale, debounce, generateId

A typical applet is 80-150 lines of code. See docs/applet-development.md for a full tutorial.

git clone https://github.com/hakaitech/netr.git
cd netr

# Development — hot-reload for frontend and backend
docker compose up

That's it. Vite HMR on localhost:5173, API on :8787.

Source files are bind-mounted, so edits in src/ and server/src/ reflect instantly — no rebuild needed.

# Production — optimized single container
docker compose --profile prod up --build

The production image builds the Vite frontend, serves it through nginx on port 80, and runs the Hono API internally. One container, one port.

git clone https://github.com/hakaitech/netr.git
cd netr

# Install dependencies
npm install
cd server && npm install && cd ..

# Start backend (port 8787)
cd server && npm run dev:node &

# Start frontend (port 5173)
npm run dev

Open http://localhost:5173. Pick a preset board or build your own from the catalog.

Requirements: Node 22+, npm 10+

# Start dev environment
docker compose up

# Start dev environment in background
docker compose up -d

# View logs
docker compose logs -f frontend-dev
docker compose logs -f api

# Rebuild after dependency changes (package.json)
docker compose up --build

# Production build & run
docker compose --profile prod up --build

# Stop everything
docker compose down

# Stop and remove volumes
docker compose down -v

Netr is designed to be extended. Two paths:

Create a new directory under src/applets/, export a manifest and a default Solid component, register it in builtin-registry.ts. Done.

Bundle your applet as an ESM module, host it anywhere, and load it at runtime via the plugin registry. No rebuild required.

Full guides:

• Building Your First Applet
• SDK API Reference
• External Plugin System
• Architecture Overview

Netr aggregates data from these open services. We are grateful for their public APIs:

Note: Many applets currently use realistic mock data. As you connect real API keys and endpoints, the live data will flow through the same SDK hooks — just swap the fetcher function.

This project was inspired by and builds upon the work of koala73/worldmonitor — an AI-powered global monitoring system. Netr takes the original concept and reimagines it with a focus on performance, modularity, and extensibility.

MIT