@altara/aerospace

Flight-instrument React components for Altara. Embeddable Primary Flight Display (PFD), Horizontal Situation Indicator (HSI), altimeter, airspeed indicator, vertical speed indicator (VSI), engine instrument cluster, TCAS traffic display, terrain-awareness display (TAWS), autopilot mode annunciator, fuel gauge, and radio altimeter — for drone ground stations, eVTOL monitoring, UAV simulators, aviation dashboards, 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>
  );
}

See it live: Website · Live demo · Storybook

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

🚀 Open the live Storybook for interactive demos — or jump straight to the live demo dashboard (Drone / Aerospace tab).

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.

Pair with @altara/ros to wire a PFD to a sensor_msgs/Imu topic, or with @altara/mqtt for broker-published telemetry.

Documentation

• 📚 Storybook — open the Aerospace/ section for the full component playground (Default + Playground stories, props in Controls, dark/light theme toggle).
• 🛰️ Live demo — Drone / Aerospace tab.

Or run them locally:

git clone https://github.com/JayaSaiKishanChapparam/altara.git
cd altara
pnpm install
pnpm --filter @altara/storybook storybook   # http://localhost:6006
pnpm --filter @altara/demo dev              # http://localhost:5173

Sibling packages

| Package | What it does | | --- | --- | | @altara/core | Components, hooks, MQTT/mock adapters, design tokens. The starting point. | | @altara/ros | ROS2 / rosbridge adapter + typed factories for common sensor_msgs/* message types. | | @altara/mqtt | MQTT-over-WebSocket adapter for IoT brokers. |

Links

• Storybook (live) · Demo dashboard (live)
• GitHub repository
• Issue tracker
• Discussions

Stability

Pre-1.0. Every package is below 1.0.0, and until one reaches it the public API is not considered stable:

• Patch (0.2.1 -> 0.2.2) — bug fixes, docs, packaging. Safe.
• Minor (0.2.x -> 0.3.0) — new features, and may include breaking changes. This is the pre-1.0 semver allowance, not an accident. Pin the minor (~0.2.0) if you need that not to happen.
• Breaking changes are always described in the package's CHANGELOG; anything spanning packages also lands in MIGRATION.md.

In practice the component APIs have been stable since 0.1.0 and every break so far has been in the adapter layer. That is a track record, not a guarantee.

License

MIT — see LICENSE.