@altara/aerospace

Flight-instrument React components for Altara. Embeddable Primary Flight Display, HSI, altimeter, airspeed, VSI, engine cluster, TCAS, TAWS, FMA, fuel gauge, and radio altimeter — built for drone ground stations, eVTOL monitoring, UAV simulators, and aerospace research.

Install

npm install @altara/core @altara/aerospace

Import the design-token stylesheet from @altara/core once at your app root:

import '@altara/core/styles.css';

Quick start

import { AltaraProvider } from '@altara/core';
import { PrimaryFlightDisplay } from '@altara/aerospace';

export function App() {
  return (
    <AltaraProvider theme="dark">
      <PrimaryFlightDisplay mockMode size="lg" />
    </AltaraProvider>
  );
}

Components

| Component | Description | | --- | --- | | PrimaryFlightDisplay | Composite PFD — attitude sphere + airspeed/altitude/heading tapes + VSI + flight director. | | HorizontalSituationIndicator | Garmin G1000-style HSI with course needle, CDI, heading bug, two bearing pointers. | | Altimeter | Drum-and-pointer altitude display with Kollsman window and optional AGL readout. | | VerticalSpeedIndicator | Arc gauge ±2000 ft/min with central digital readout. | | AirspeedIndicator | Round dial with FAA arc zones (white / green / yellow) and Vne red line. | | EngineInstrumentCluster | Multi-engine RPM/EGT/fuel-flow/oil bar gauges with per-parameter thresholds. | | RadioAltimeter | Digital AGL readout with decision-height bug and crossing callback. | | TerrainAwareness | TAWS-style forward terrain footprint coloured by relative altitude. | | TCASDisplay | Plan-position traffic display with threat-level glyphs. | | AutopilotModeAnnunciator | Flight mode annunciator strip — A/T, lateral, vertical, AP, FD. | | FuelGauge | Per-tank bar gauges with totaliser and reserve marker. |

Showcase

Live, interactive demos of every component are at the Altara Storybook — pnpm --filter @altara/storybook storybook.

Data sources

Every component accepts an AltaraDataSource from @altara/core. The PFD/HSI route by TelemetryValue.channel (roll, pitch, heading, airspeed, altitude, vs, etc.). Single-value components (Altimeter, AirspeedIndicator, VerticalSpeedIndicator, RadioAltimeter) take any data source directly.

License

MIT