A modern React rewrite of tar1090, the popular ADS-B aircraft tracking web interface. Built with React 19, TypeScript, and OpenLayers — fully compatible with the original tar1090 data backend.
- Real-time aircraft tracking on an interactive map
- History playback with timeline controls
- Aircraft detail view with registration, route, photo lookup, and more
- Statistics dashboard with various charts
- Dark mode UI
- Mobile-responsive layout
- Internationalization (English & Simplified Chinese)
- KML export for aircraft tracks
- Node.js 20+
- pnpm (recommended) or npm
git clone https://github.com/aomsir/tar1090-react.git
cd tar1090-react
pnpm install
pnpm run vendor-db # download aircraft database
pnpm devCreate a .env.local file to point at your ADS-B data source:
VITE_PROXY_TARGET=https://your-tar1090-server.example.compnpm build
pnpm previewsrc/
├── app/ # App shell, layout, routing
├── config/ # App-wide configuration constants
├── data/ # Data fetching, polling, decoders
├── domain/ # Core domain logic (aircraft, altitude, units…)
├── features/ # Feature modules (live, playback, stats, detail…)
├── i18n/ # Internationalization resources
├── map/ # OpenLayers map layers, styles, markers
├── store/ # Zustand state stores
└── ui/ # UI components (Toolbar, ListPanel, StatsDashboard…)
| Category | Technologies |
|---|---|
| Framework | React 19, TypeScript |
| Build | Vite |
| Styling | Tailwind CSS v4, HeroUI v3 |
| Map | OpenLayers |
| State | Zustand |
| Data | TanStack Query |
| Charts | Recharts |
| i18n | i18next |
| Testing | Vitest |
- Fork the repository
- Create a feature branch (
git checkout -b feat/your-feature) - Commit your changes
- Push to the branch and open a Pull Request
- Multi-receiver support
- PWA offline mode
- More language packs
- Performance optimizations for high-traffic feeds
This project is a React-based rewrite inspired by the original tar1090 by wiedehopf (Matthias Wirth), which is itself based on dump1090 by FlightAware. Huge thanks to both projects for their contributions to the ADS-B open-source community.
Additional credits:
- tar1090-db — Aircraft database for type/registration lookups
- country-flag-icons by @catamphetamine — Country flag SVGs
GPL-2.0-or-later — see LICENSE.