README.md

April 15, 2026 · View on GitHub

Resgrid

BigBoard

Real-time situational awareness dashboard for first responders

Build Status License Expo 54 React Native TypeScript Platforms


BigBoard is a cross-platform dashboard that connects to the Resgrid platform, giving fire departments, EMS, search & rescue, CERT, HAZMAT, and other emergency services a live operational picture — right on a wall-mounted display, tablet, or phone.

Features

Customizable Widget Dashboard

Drag-and-drop grid of resizable widgets, each independently configurable:

WidgetDescription
PersonnelLive roster with status and staffing levels
Personnel Status SummaryAt-a-glance status breakdown across all personnel
Personnel Staffing SummaryStaffing level overview with counts per category
UnitsApparatus and vehicle tracking with current status
Units SummaryAggregated unit status counts
CallsActive dispatch calls with priority and type info
Calls SummaryCall volume and status breakdown
Scheduled CallsUpcoming scheduled calls with urgency color coding, filtering, and sorting
MapInteractive Mapbox-powered map with personnel and unit markers
WeatherCurrent conditions for your station area
Weather AlertsActive NWS weather alerts and warnings
NotesShared notes and shift information
TimeClock and date display

Real-Time Updates

  • SignalR push connection keeps every widget in sync without polling
  • Automatic reconnection and lifecycle management

Multi-Platform

PlatformHow to run
iOSyarn ios
Androidyarn android
Webyarn web
Electron (macOS, Windows, Linux)yarn electron:dev

Additional Capabilities

  • SSO & OAuth authentication
  • Push notifications via Expo Notifications & Notifee
  • i18n — fully internationalized UI
  • Dark mode support
  • BLE device integration
  • LiveKit real-time audio/video
  • Sentry error monitoring
  • Mapbox mapping with GeoJSON support

Getting Started

Prerequisites

  • Node.js >= 18
  • Yarn 1.22+
  • For native builds: Xcode (iOS) or Android Studio (Android)

Install

git clone https://github.com/Resgrid/BigBoard.git
cd BigBoard
yarn install

Run

# Start the Expo dev server
yarn start

# Or target a specific platform
yarn ios
yarn android
yarn web

# Electron (desktop)
yarn electron:dev

Build for Production

# Electron desktop builds
yarn electron:build:mac
yarn electron:build:win
yarn electron:build:linux

# EAS cloud builds (iOS / Android)
yarn build:production:ios
yarn build:production:android

Project Structure

src/
├── app/              # Expo Router screens (file-based routing)
├── api/              # API clients (calls, personnel, units, weather, etc.)
├── components/       # Reusable components & dashboard widgets
├── hooks/            # Custom React hooks (SignalR, queries, etc.)
├── stores/           # Zustand state management
├── translations/     # i18n locale files
├── types/            # TypeScript type definitions
└── core/             # Core utilities and providers
electron/             # Electron main process & preload

Tech Stack

LayerTechnology
FrameworkReact Native 0.81 + Expo 54
NavigationExpo Router (file-based)
StylingNativeWind (Tailwind CSS)
StateZustand
Data FetchingTanStack React Query
Real-TimeSignalR
UI ComponentsGluestack UI
MapsMapbox GL
FormsReact Hook Form + Zod
DesktopElectron

About Resgrid

Resgrid is a software-as-a-service logistics, management, and communications platform for first responders — volunteer and career fire departments, EMS, search and rescue, public safety, HAZMAT, CERT, disaster response, and more.

Sign up for your free Resgrid account

Authors

License

Apache 2.0 — see LICENSE.txt for details.