app-store-preflight-compliance

name: app-store-preflight-compliance description: Pre-submission compliance scanner workflow for Apple App Store apps. Use when reviewing iOS, macOS, tvOS, watchOS, or visionOS projects (Swift, Objective-C, React Native, Expo) for App Store rejection risks, submission readiness, privacy compliance, or guideline violations.

App Store Preflight Compliance

Run Greenlight checks, fix findings, and repeat until the project reaches GREENLIT status.

Workflow

1. Run greenlight preflight at the project root.
2. Triage findings by severity (CRITICAL, then WARN, then INFO).
3. Apply concrete code/configuration fixes.
4. Re-run and continue until no CRITICAL findings remain.

Step 1: Run Scan

greenlight preflight .

If an IPA is available:

greenlight preflight . --ipa /path/to/build.ipa

If greenlight is missing, install it:

# Homebrew (macOS)
brew install revylai/tap/greenlight

# Go
go install github.com/RevylAI/greenlight/cmd/greenlight@latest

# Build from source
git clone https://github.com/RevylAI/greenlight.git
cd greenlight && make build

Step 2: Fix Findings

Fix in order:

1. CRITICAL: must fix before submission.
2. WARN: high rejection risk, strongly recommended to fix.
3. INFO: best-practice improvements.

Common fixes:

• Move hardcoded secrets to environment variables.
• Replace external payment flows for digital goods with StoreKit/IAP.
• Add Sign in with Apple when social login exists.
• Add account deletion when account creation exists.
• Remove references to competing platforms.
• Replace placeholder text (Lorem ipsum, TBD, Coming soon).
• Rewrite vague purpose strings with concrete app behavior.
• Replace hardcoded IPs with hostnames.
• Replace http:// URLs with https://.
• Remove debug logs or gate them behind development flags.
• Add missing privacy policy URL and required App Store metadata.

Step 3: Re-Run Until GREENLIT

greenlight preflight .

Continue until output reports GREENLIT (zero CRITICAL findings).

Useful Commands

greenlight codescan .
greenlight privacy .
greenlight ipa /path/to/build.ipa
greenlight scan --app-id <ID>
greenlight guidelines search "privacy"

Attribution

Original project and workflow: RevylAI/greenlight.

Credit to Lanseer and the Revyl team for creating Greenlight. This package is a Codex-native adaptation for the same workflow.