# Flightline

> Flightline is an open-source App Store Connect CLI. Manage supported configuration in YAML, review diffs, apply changes, and submit releases with explicit confirmation. Read sales, finance, analytics, reviews and performance reports from the same tool.

Flightline talks directly to Apple using your App Store Connect API key. It does not build, sign or upload app binaries. Applying YAML does not submit an App Store release; draft assembly and final submission are separate confirmed actions. Preflight checks do not guarantee Apple approval. Some operations have partial coverage; consult the capabilities reference.

## Start here

- [Website](https://flightline.dev): Product overview.
- [Features](https://flightline.dev/features): Configuration, release workflows and reports.
- Install: https://flightline.dev/docs/getting-started/install.md
- Changelog: https://flightline.dev/changelog
- Source: https://github.com/ul0gic/flightline
- Full docs as one markdown file: https://flightline.dev/llms-full.txt

Every docs link below is raw markdown (the HTML page lives at the same URL without ".md").

## Getting Started

- [Install](https://flightline.dev/docs/getting-started/install.md): Install Flightline, the App Store Connect CLI, with Go or from source. Verify your installation and continue to API key setup.
- [App Store Connect API key](https://flightline.dev/docs/getting-started/apple-api-key.md): Set up an App Store Connect API key for Flightline. Configure credentials, protect your private key, and troubleshoot authentication.
- [First run](https://flightline.dev/docs/getting-started/first-run.md): Run your first Flightline commands: inspect an app, fetch App Store Connect state into YAML, validate it, and preview changes.
## Guides

- [State as code](https://flightline.dev/docs/guides/state-as-code.md): Manage App Store Connect configuration in YAML with Flightline. Fetch live state, edit locally, review a plan, apply changes, and verify the result.
- [Uploading assets](https://flightline.dev/docs/guides/uploading-assets.md): Upload App Store screenshots, preview videos and review attachments with Flightline. Check processing status and recover interrupted uploads.
- [Preflight in CI](https://flightline.dev/docs/guides/preflight-in-ci.md): Run Flightline lint and preflight checks in CI. Configure credentials, interpret exit codes, and inspect JSON diagnostics before submission.
- [Observability: reports, reviews, and metrics from the terminal](https://flightline.dev/docs/guides/observability.md): Read App Store sales, finance, analytics, reviews, beta feedback and performance reports with Flightline. Export results for scripts and analysis.
- [Submission and release](https://flightline.dev/docs/guides/submission-and-release.md): Prepare an App Store review draft, confirm its items, submit it explicitly, and manage release actions with Flightline.
- [Non-subscription IAP commerce](https://flightline.dev/docs/guides/iap-commerce.md): Manage in-app purchase metadata, pricing, supported territories and offer workflows in App Store Connect with Flightline.
- [TestFlight metadata and distribution](https://flightline.dev/docs/guides/testflight.md): Manage TestFlight metadata, groups, testers and build membership with Flightline. Prepare external beta review with explicit confirmation.
- [In-App Events: draft, localize, upload, inspect](https://flightline.dev/docs/guides/events.md): Manage App Store in-app events, localizations and media with Flightline. Prepare item proposals for a separate review submission.
- [Product page experiments: treatments, assets, review proposal](https://flightline.dev/docs/guides/experiments.md): Manage App Store product page experiments, treatments and assets with Flightline. Review the supported lifecycle actions and limits.
- [Declarations and visibility](https://flightline.dev/docs/guides/declarations.md): Manage App Store content rights, custom EULA, accessibility declarations and tags with Flightline. Understand supported writes and limits.
- [Review responses and webhooks](https://flightline.dev/docs/guides/review-responses-and-webhooks.md): Read and respond to App Store customer reviews, manage webhooks, and inspect deliveries with explicit Flightline commands.
## Reference

- [Capabilities and workflow boundaries](https://flightline.dev/docs/reference/capabilities.md): Check Flightline workflow coverage across App Store Connect commands, YAML configuration and preflight checks, including current limitations.
- [Flightline AppState: YAML Reference](https://flightline.dev/docs/reference/state-yaml.md): Reference for Flightline state.yaml: App Store Connect fields, types, constraints and write behavior for metadata, assets, purchases and TestFlight.
- [Preflight rules](https://flightline.dev/docs/reference/preflight-rules.md): Reference for Flightline preflight rules: rule IDs, offline and live checks, severity levels, exit codes and corrective actions.
- [CLI reference](https://flightline.dev/docs/reference/cli.md): Flightline CLI reference for App Store Connect: commands, arguments, required flags, defaults and examples generated from the command definitions.
- [JSON output](https://flightline.dev/docs/reference/json-output.md): Use Flightline JSON output in scripts and CI. Learn response formats, diagnostics, exit codes and jq patterns for App Store Connect workflows.
- [App Store Connect API compatibility](https://flightline.dev/docs/reference/api-compatibility.md): Review Flightline compatibility with the App Store Connect API, including the pinned API reference, supported boundaries and update process.
## Concepts

- [The three-layer model](https://flightline.dev/docs/concepts/three-layer-model.md): Understand Flightline’s three layers: direct App Store Connect commands, YAML state management, and offline or live preflight checks.