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:
| Color | Alert Level | Meaning |
|---|---|---|
| Red | RED | High humanitarian impact, likely requires international response |
| Orange | ORANGE | Moderate impact, regional response may be needed |
| Green | GREEN | Low impact, monitoring recommended |
Markers also display an icon indicating the event type:
| Icon | Event Type |
|---|---|
| Seismograph | Earthquake (EQ) |
| Cyclone | Tropical Cyclone (TC) |
| Water | Flood (FL) |
| Volcano | Volcanic Activity (VO) |
| Sun | Drought (DR) |
| Fire | Wildfire (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
| Shortcut | Action |
|---|---|
/ | Focus the search/filter input |
Esc | Clear active filters |
Enter | Open the selected event detail |
Next Steps
- Event Detail View — What you see when you click into an event
- Knowledge Base — AI-powered article discovery and summaries
- Reports — Generate comprehensive event reports
Quick Start
Get the TerraGuard platform running on your local machine in minutes. Covers prerequisites, setup, and verification for all six services.
Event Detail View
The event detail page presents comprehensive information about a single disaster event, including measurements, timeline, affected areas, linked news, AI summaries, and knowledge base entries.