AirTrail

<div align="center">
  <br/>
  <a href="https://hub.docker.com/r/johly/airtrail/">
    <img src="https://img.shields.io/docker/pulls/johly/airtrail?style=for-the-badge" alt="Docker pulls">
  </a>
  <a href="https://github.com/johanohly/AirTrail/releases/latest">
    <img src="https://img.shields.io/github/v/release/johanohly/AirTrail?style=for-the-badge" alt="Latest version">
  </a>
  <a href="https://github.com/johanohly/AirTrail/stargazers">
    <img src="https://img.shields.io/github/stars/johanohly/AirTrail?style=for-the-badge" alt="Stars">
  </a>
  <br/>
  <br/>
</div>

<div align="center">
  <a href="https://airtrail.johan.ohly.dk/">
    <img src="static/favicon.png" alt="AirTrail logo" width="80" height="80">
  </a>

<h3 align="center">AirTrail</h3>

  <p align="center">
    A web application that allows users to track their flights and view their flight history.
  </p>
</div>

<img src="static/showcase/toggle.png" alt="AirTrail Preview">

## ✨ Features

- **World Map**: View all your flights on an interactive world map.
- **Flight History**: Keep track of all your flights in one place.
- **Statistics**: Get insights into your flight history with statistics.
- **Multiple Users**: Manage multiple users, share flights among them, secure your data with user authentication and
  integrate with your OAuth provider.
- **Responsive Design**: Use the application on any device with a responsive design.
- **Dark Mode**: Switch between light and dark mode.
- **Import Flights**: Import flights from various sources including MyFlightRadar24, App in the Air, JetLog, TripIt, Flighty and byAir.

## 🚀 Getting Started

- [Documentation](https://airtrail.johan.ohly.dk/docs/overview/introduction)
- [Installation](https://airtrail.johan.ohly.dk/docs/overview/quick-start)
- [About](https://airtrail.johan.ohly.dk/docs/overview/introduction)
- [Demo](https://demo.airtrail.johan.ohly.dk)
- [Contributing](https://airtrail.johan.ohly.dk/docs/overview/contributing)

## 🤝 Contributing

Want to contribute to AirTrail? Awesome! Check out the [contributing documentation](CONTRIBUTING.md) to get started.

If you find an issue, please report it on the [issue tracker](https://github.com/johanohly/AirTrail/issues/new/choose).

## Build Status

[![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/JohanOhly/AirTrail/build.yml?logo=github&style=for-the-badge)](https://github.com/JohanOhly/AirTrail/releases/latest)

#### Sonarcloud Quality metrics

[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=johanohly_AirTrail&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=johanohly_AirTrail)
[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=johanohly_AirTrail&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=johanohly_AirTrail)
[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=johanohly_AirTrail&metric=bugs)](https://sonarcloud.io/summary/new_code?id=johanohly_AirTrail)
[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=johanohly_AirTrail&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=johanohly_AirTrail)
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=johanohly_AirTrail&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=johanohly_AirTrail)
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=johanohly_AirTrail&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=johanohly_AirTrail)

#### FOSSA license and security scans

[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fjohanohly%2FAirTrail.svg?type=shield&issueType=license)](https://app.fossa.com/projects/git%2Bgithub.com%2Fjohanohly%2FAirTrail?ref=badge_shield&issueType=license)
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fjohanohly%2FAirTrail.svg?type=shield&issueType=security)](https://app.fossa.com/projects/git%2Bgithub.com%2Fjohanohly%2FAirTrail?ref=badge_shield&issueType=security)
[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2Fjohanohly%2FAirTrail.svg?type=small)](https://app.fossa.com/projects/git%2Bgithub.com%2Fjohanohly%2FAirTrail?ref=badge_small)

#### OpenSSF best practices

[![CII Best Practices](https://bestpractices.coreinfrastructure.org/projects/9689/badge)](https://bestpractices.coreinfrastructure.org/projects/9689)
[![OpenSSF Scorecard](https://api.scorecard.dev/projects/github.com/johanohly/AirTrail/badge)](https://scorecard.dev/viewer/?uri=github.com/johanohly/AirTrail)

## Star History

<a href="https://star-history.com/#johanohly/AirTrail&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=johanohly/AirTrail&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=johanohly/AirTrail&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=johanohly/AirTrail&type=Date" />
 </picture>
</a>

## Acknowledgements

### Data Sources

> [Airport Data](https://ourairports.com)

> [Country Borders](https://gisco-services.ec.europa.eu/distribution/v2/countries/geojson/CNTR_RG_01M_2024_4326.geojson)

> [Country Flags](https://flagpedia.net)

### Airline Icons

The airline icon list ([`static/airlines`](static/airlines)) is based on [Soaring Symbols](https://github.com/anhthang/soaring-symbols) by Anh Thang.

Airline logos/icons are provided for identification and reference purposes only. AirTrail does not claim ownership of any trademarks or copyrighted materials in those logos. All logos remain the intellectual property of their respective airlines.

### Logo

The logo is from Lucide, which is a free icon pack that can be found [here](https://www.lucide.dev/).

> Copyright (c) for portions of Lucide are held by Cole Bemis 2013-present as part of Feather (MIT). All other copyright (
> c) for Lucide are held by Lucide Contributors 2026.