Skip to content

MaTriXy/StoreReady

Repository files navigation

StoreReady

StoreReady

Know before you submit.

Pre-submission checkup for mobile apps on Google Play and Apple App Store.

Install  •  Usage  •  What It Checks  •  Google Play Docs  •  Apple Docs  •  All Commands


Install

brew install matrixy/tap/storeready
Other methods
go install github.com/MaTriXy/StoreReady/cmd/storeready@latest
git clone https://github.com/MaTriXy/StoreReady.git
cd StoreReady && make build

Usage

storeready playstore-checkup .       # Google Play
storeready appstore-checkup .        # Apple App Store
storeready release-checklist         # Manual Apple release gates
storeready publish --app-id <ID> --version <X.Y.Z> --build <BUILD_ID>  # ASC dry-run lane

Findings are sorted by severity:

Level Meaning
CRITICAL Will be rejected — must fix
WARN High rejection risk — should fix
INFO Best practice — consider fixing

What It Checks

Google Play Apple App Store
Manifest / config AndroidManifest flags, Gradle metadata, package ID Info.plist, app.json, bundle ID, privacy policy URL
Code patterns 30+ rejection-risk patterns across Swift, Kotlin, React Native, Expo Same scanner, plus private API detection
Permissions High-risk Play permissions requiring declarations Purpose strings, ATT for tracking SDKs
Privacy PrivacyInfo.xcprivacy, Required Reason APIs
Binary IPA inspection: icons, size, launch storyboard, ATS
Store API App Store Connect: metadata, screenshots, builds
Release lane release-checklist + publish (ASC CLI gated flow)
Guidelines Built-in Play policy matrix Built-in Apple Review Guidelines
Policy checklist Automated + manual review items Automated + manual review items

CI/CD

- name: Store compliance check
  run: |
    storeready playstore-checkup . --format json --output play-report.json
    storeready appstore-checkup . --format json --output apple-report.json

All commands support --format json and --output <file> for pipeline integration.

Apple End-to-End Lane

# 1) Manual/hybrid policy gates not fully automatable
storeready release-checklist --app-type all

# 2) Automated local + ASC gates, then ASC release dry-run
storeready publish --app-id <ID> --version <X.Y.Z> --build <BUILD_ID>

# 3) Real submit after review
storeready publish --app-id <ID> --version <X.Y.Z> --build <BUILD_ID> --confirm

AI Integrations

Claude Code:

npx skills add https://github.com/MaTriXy/StoreReady --skill "Store Preflight Compliance"

Codex:

cp -R codex-skill/* ~/.codex/skills/store-preflight-compliance/

Then invoke with $store-preflight-compliance in either tool.


Google Play  •  Apple App Store  •  All Commands  •  Release Notes  •  License (MPL-2.0)

About

Pre-submission checkup for mobile apps

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors