One command to check a mobile build before the stores do. app-check auto-detects the artifact,
runs the right audit, and aggregates the result:
npx @njweber/app-check ./build/app-release.aab ./build/YourApp.ipa ./assets/icon.png| Artifact | What it's checked for | Under the hood |
|---|---|---|
*.aab |
Android 16 KB page size and the manifest audit | store-check + manifest-check |
*.apk |
Android 16 KB page size | store-check |
AndroidManifest.xml |
Android manifest audit | manifest-check |
*.ipa |
App Store submission pitfalls and privacy usage descriptions | ipa-check + privacy-check |
*.png |
icon size / alpha rules | icon-check |
✓ store-check — 16 KB page-size audit
…
✓ ipa-check — iOS submission audit
…
✗ icon-check — app icon audit
✗ ios-alpha has an alpha channel — the App Store icon must have NO transparency
✗ app-check: 3 checks, 1 failed.
# explicit files
npx @njweber/app-check ./app-release.aab ./YourApp.ipa
# scan a build directory (recursive; skips node_modules/.git/ios/android)
npx @njweber/app-check --dir ./dist
# options
npx @njweber/app-check ./assets/icon.png --android # adaptive-icon foreground rules
npx @njweber/app-check ./YourApp.ipa --bundle-id com.acme.app
npx @njweber/app-check --dir ./dist --json # machine-readableExit codes: 0 all good · 1 at least one blocking issue · 2 bad input.
- uses: nwebersoftware/app-check@main
with:
path: distIt's a fast, offline pre-flight — not a substitute for the store's own validation. It catches the mechanical rejections (alignment, plist shape, icon alpha) that are cheap to check and expensive to discover mid-review.
Each check is also its own focused tool: store-check · manifest-check · ipa-check · privacy-check · icon-check.
An .ipa deliberately runs two audits — submission shape (ipa-check) and privacy declarations
(privacy-check). An .aab runs two as well — the 16 KB page-size check (store-check) and the
manifest audit (manifest-check).
More of this at https://booleanbuild.com — the tools hub, plus write-ups on store rejections, CI, build gates, and shipping TestFlight builds without EAS. New posts land roughly twice a month. Subscribe: https://booleanbuild.com/#subscribe
MIT.