TerraGuard

Dashboard & Event Map

The main TerraGuard dashboard provides a real-time map of disaster events worldwide, with filtering, severity indicators, and quick access to event details.

Overview

The dashboard is the primary interface for monitoring disaster events. It combines an interactive map with a filterable event list, giving response teams a comprehensive view of ongoing and recent disasters across all monitored data sources.

Screenshot: Main dashboard view showing the interactive map on the left with colored event markers and the event list panel on the right

Map View

The interactive map displays disaster events as markers positioned at their geographic coordinates. The map is built with MapLibre GL and supports smooth pan, zoom, and rotation.

Event Markers

Each marker represents a single disaster event. Markers are color-coded by alert level:

ColorAlert LevelMeaning
RedREDHigh humanitarian impact, likely requires international response
OrangeORANGEModerate impact, regional response may be needed
GreenGREENLow impact, monitoring recommended

Markers also display an icon indicating the event type:

IconEvent Type
SeismographEarthquake (EQ)
CycloneTropical Cyclone (TC)
WaterFlood (FL)
VolcanoVolcanic Activity (VO)
SunDrought (DR)
FireWildfire (WF)

Marker Clustering

When the map is zoomed out, nearby markers are automatically clustered. The cluster circle shows the count of events in that area and is colored based on the highest alert level within the cluster. Zooming in expands clusters into individual markers.

Screenshot: Map zoomed out showing clustered markers with counts, and a zoomed-in view showing individual event markers with type icons

Click-to-Detail

Clicking any event marker opens a popup with a brief summary:

  • Event title and type
  • Alert level badge
  • Date and time
  • Location name
  • A "View Details" link to the full event detail page

Event List

The right panel displays events in a scrollable list, sorted by date (most recent first). Each list item shows:

  • Event title — e.g., "M 6.2 Earthquake - Papua New Guinea"
  • Alert level badge — Color-coded RED, ORANGE, or GREEN
  • Event type — Icon and label
  • Date — When the event was first reported
  • Location — Country and region
  • Severity indicator — Based on measurements (magnitude, wind speed, etc.)

Screenshot: Event list panel showing several disaster events with alert level badges, type icons, and date/location information

Clicking any item in the list navigates to the event detail page and centers the map on that event's location.

Filtering

The filter panel lets you narrow events by multiple criteria simultaneously.

Screenshot: Filter panel expanded showing dropdown selectors for event type, alert level, date range picker, and country search

Available Filters

Event Type — Select one or more disaster types:

  • Earthquake, Tropical Cyclone, Flood, Volcano, Drought, Wildfire

Alert Level — Filter by severity:

  • RED, ORANGE, GREEN, or any combination

Date Range — Specify a start and end date to view events within a time window. Preset options include:

  • Last 24 hours
  • Last 7 days
  • Last 30 days
  • Custom range

Country — Search and select specific countries to see only events affecting those regions.

Data Source — Filter by originating source:

  • GDACS, USGS, NHC

Filter Behavior

Filters are combined with AND logic — selecting "Earthquake" + "RED" shows only red-alert earthquakes. The map and event list update in real time as filters change. Active filters are displayed as removable chips above the list.

The URL updates with filter parameters, so filtered views can be bookmarked or shared with team members.

Real-Time Updates

The dashboard polls for new events at regular intervals. When new events arrive:

  • New markers appear on the map with a brief animation
  • The event list updates with new entries at the top
  • A notification badge shows the count of new events since last interaction

Events that are updated (e.g., an earthquake's magnitude is revised, or a cyclone's alert level changes) are reflected on the dashboard without requiring a page refresh.

Keyboard Shortcuts

ShortcutAction
/Focus the search/filter input
EscClear active filters
EnterOpen the selected event detail

Next Steps

On this page