# Flights

Flights are the core of FlightLog. Every session you log -- whether a revenue flight, simulator session, or ground training -- lives here.

***

## Flight List

The flight list displays your logbook entries in reverse-chronological order, paginated at 50 flights per page.

Each flight card shows:

* **Date** (local departure date)
* **Departure / Arrival** airports (IATA and ICAO codes)
* **OUT / IN times** with delay indicators when applicable
* **Flight number** with the airline logo
* **Block time**
* **Takeoff and landing counts**

### Delay Indicators

Flight cards display a color-coded delay badge comparing actual vs scheduled times:

| Badge Color | Meaning                      |
| ----------- | ---------------------------- |
| Green       | Ahead of schedule            |
| Orange      | Late by less than 15 minutes |
| Red         | Late by 15 minutes or more   |

### Proficiency Check Icon

A green **shield icon** is shown on flights marked as proficiency or line checks, so you can spot them instantly in the list.

### Airline Logo

When a flight number includes a known airline code, the corresponding **airline logo** is displayed on the card alongside the flight number.

### Session Type Color Coding

Cards are color-coded by session type:

| Color | Session Type |
| ----- | ------------ |
| Blue  | FLIGHT       |
| Green | SIMULATOR    |
| Grey  | GENERAL      |

### Search and Filter

* Type in the search bar to find flights by **airport code**, **flight number**, **aircraft registration/name**, or **date**.
* Use the **monthly filter** (month picker) to narrow results to a specific month. Tap the month/year selector above the list to choose any month, then only flights within that month are shown.

### Pull-to-Refresh

Pull down on the flight list to refresh flight times from airline data (e.g., AF schedule updates). Updated OUT/IN times and delays are fetched and applied to matching flights.

### Delete a Flight

Swipe a flight card to the left to reveal the delete action.

> **Tip:** Deleted flights cannot be recovered unless you restore from a backup.

***

## Creating a Flight

Tap the **"+"** floating action button at the bottom of the flight list.

1. **Session type** -- choose FLIGHT, SIMULATOR, or GENERAL.
2. **Date** -- select the flight date.
3. **Flight number** -- enter the airline and flight number.
4. **FROM / TO airports** -- type to search; the auto-lookup resolves the ICAO/IATA code and applies the correct timezone.
5. **OUT / IN times** -- enter block-off and block-on times. Block time is computed automatically.
6. **TAXI OUT / TAXI IN** -- enter taxi-out and taxi-in times if known. These are displayed alongside block times.
7. **Aircraft** -- open the search picker modal and select or create an aircraft.
8. **Function on board** -- choose one: PIC, SIC, PICus, SPIC, INS, EXAM, REL, or DUAL.
9. **PF / PM** -- toggle Pilot Flying or Pilot Monitoring.
10. **Rules** -- toggle between **VFR** and **IFR**.
11. **Save**.

> **Tip:** Airport timezone detection ensures block time is calculated correctly even for flights crossing multiple time zones.

***

## Flight Detail

Tap any flight in the list to open its detail view. All fields are editable.

Use the **left/right navigation arrows** at the top to browse through flights without returning to the list.

### Sections

| Section                    | Contents                                                                                                                                                                                                                                                                     |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Route header**           | Departure and arrival airports with operational warning icons when available                                                                                                                                                                                                 |
| **Times**                  | Scheduled, actual, off-block, and on-block times                                                                                                                                                                                                                             |
| **Taxi times**             | TAXI OUT and TAXI IN durations                                                                                                                                                                                                                                               |
| **Stand information**      | Departure stand and arrival stand fields                                                                                                                                                                                                                                     |
| **Aircraft info**          | Registration, type code, type name                                                                                                                                                                                                                                           |
| **Rules**                  | VFR / IFR toggle                                                                                                                                                                                                                                                             |
| **Crew times**             | PIC, SIC, dual, instruction, and relief time                                                                                                                                                                                                                                 |
| **Hold time**              | Holding time accumulated during the flight                                                                                                                                                                                                                                   |
| **Crew**                   | Crew list with name and function for each member (see below)                                                                                                                                                                                                                 |
| **PIC NAME**               | Name of the Pilot in Command; auto-extracted from the crew list when a crew member has the PIC function, or entered manually. A **Self** button fills your own name when you are PIC. Exported to PDF reports                                                                |
| **Proficiency Check**      | Toggle to mark a flight as a proficiency or line check. When active, adds **Examiner Name** (with a **PIC** quick-fill button) and a **Signature Pad** to capture the examiner's handwritten signature on a canvas. Both the examiner name and signature are exported to PDF |
| **Notes**                  | Additional notes                                                                                                                                                                                                                                                             |
| **Night time**             | Automatically computed based on sunrise/sunset along the route. Can also be edited manually                                                                                                                                                                                  |
| **IFR time**               | Instrument flight rules time                                                                                                                                                                                                                                                 |
| **Takeoffs & Landings**    | Day and night counts                                                                                                                                                                                                                                                         |
| **Approach**               | Approach type (ILS, RNAV, VOR, etc.)                                                                                                                                                                                                                                         |
| **Cosmic radiation**       | Cosmic radiation dose estimate in microsieverts, computed from altitude, latitude, and flight duration                                                                                                                                                                       |
| **Time dilation**          | Relativistic time dilation calculation for the flight, computed from altitude and speed                                                                                                                                                                                      |
| **CO2 / Green metrics**    | Fuel efficiency expressed in t.km/L and PAX.km/L, plus estimated CO2 emissions for the flight                                                                                                                                                                                |
| **Include in Performance** | Toggle to include or exclude this flight from performance statistics (D0, fuel delta, etc.)                                                                                                                                                                                  |
| **Weather icon**           | Current weather conditions with temperature display for departure and arrival airports                                                                                                                                                                                       |
| **Weather**                | Link to weather data for the route                                                                                                                                                                                                                                           |
| **WX Briefing**            | Opens the full weather briefing page with METAR/TAF, thunderstorm observations and forecasts, turbulence, jetstream winds, SIGMETs, tropopause data, and a vertical profile along the route (see [WX Briefing](https://nil-4.gitbook.io/flightlog-docs/tools/wx-briefing))   |

***

## Crew List

Add crew members to any flight from the **Crew** section in the flight detail view.

* Tap **Add Crew** to add a crew member.
* Enter the crew member's **name** and select their **function** (CPT, OPL, OPR, INS, EXAM, PUR, etc.).
* The PIC NAME field is auto-populated from the crew member whose function is PIC/CPT.
* Crew data can also be pre-filled from a roster import (see CrewConnect).

***

## FPR Modal -- Flight Plan Route

Tap the **FPR** button in the flight detail to open the Flight Plan Route modal.

* Displays the full list of **waypoints** along the planned route.
* Each waypoint shows its **ETO** (Estimated Time Over) and cumulative **distance**.
* The route is used by Atlas for the map overlay and by the night-time and cosmic-radiation calculations.

***

## Airport Stats **\[PRO]**

From any flight detail, tap the airport code to access per-airport statistics:

* **Runway usage donut** -- breakdown of runway usage at that airport across all your flights.
* **D0 performance** -- on-time departure performance at the airport.
* **Fuel delta trends** -- historical fuel burn variance for flights to/from that airport.
* **Stand statistics** -- frequency of stands used at the airport.

***

## Atlas **\[PRO]**

The Atlas feature displays a high-resolution National Geographic world map with your flight route overlaid. Access it from the **PAYLOAD-FUEL-ROUTING** section of any flight detail by tapping the **ATLAS** button.

### Map Tiles

Atlas uses downloadable tile packs stored locally on your device. Tap the **layers icon** in the toolbar to manage tile packs:

| Pack             | Coverage                 | Approximate Size |
| ---------------- | ------------------------ | ---------------- |
| **Zoom 4--6**    | Low resolution           | \~93 MB          |
| **Zoom 7**       | Medium resolution        | \~216 MB         |
| **Zoom 8 (1/2)** | High resolution (part 1) | \~200 MB         |
| **Zoom 8 (2/2)** | High resolution (part 2) | \~200 MB         |

Download progress is shown in two phases: downloading then extracting. Tiles are extracted to individual files on disk -- no memory overhead during map viewing.

Each pack can be deleted independently to free storage space.

### Route Overlay

* If the flight has an **FPR route** (ATCRoute), the full route is drawn as a white great-circle polyline with waypoint markers and labels.
* If no FPR is available but the flight has departure and arrival coordinates, an **orthodromic** great-circle line is drawn between the two airports.
* The map automatically fits the route in view on open.

> **Note:** At least the Zoom 4--6 tile pack must be downloaded before the map can display.

***

## OFP Import

You can import flight data directly from an Operational Flight Plan PDF.

1. Open the OFP PDF in any app on your device (email, files, airline EFB).
2. Tap **Share** and select **FlightLog**.
3. FlightLog parses the PDF and extracts flight data automatically (route, times, fuel, crew, etc.).
4. Review the pre-filled fields and save.

> **Note:** OFP parsing accuracy depends on the PDF format. Some airline-specific formats may require manual corrections after import.
