Productivity

gpd-submission-health

rudrankriyam/app-store-connect-cli-skills · updated Apr 8, 2026

$npx skills add https://github.com/rudrankriyam/app-store-connect-cli-skills --skill gpd-submission-health
summary

Use this skill to reduce Play Console submission failures and validate readiness.

skill.md

GPD Submission Health

Use this skill to reduce Play Console submission failures and validate readiness.

Preconditions

  • Auth configured and package name resolved.
  • Build uploaded and available for the target track.
  • Store listing metadata and assets updated.

Pre-submission checklist

1. Validate edit (if using edit lifecycle)

gpd publish edit validate EDIT_ID --package com.example.app

2. Confirm release status

gpd publish status --package com.example.app --track production

Check:

  • Release status is expected (draft, inProgress, or completed).
  • Version code matches the uploaded build.

3. Verify store listing metadata

gpd publish listing get --package com.example.app
gpd publish details get --package com.example.app

4. Verify screenshots and assets

gpd publish images list phoneScreenshots --package com.example.app --locale en-US
gpd publish assets spec

5. Upload deobfuscation mapping (if needed)

gpd publish deobfuscation upload mapping.txt --package com.example.app --type proguard --version-code 123

Submit to production

gpd publish release --package com.example.app --track production --status inProgress --version-code 123

Common submission issues

Release not in valid state

Check:

  1. Version code uploaded and attached to the track.
  2. Edit validation passes.
  3. Required store listing fields present for all locales.

Missing screenshots or assets

Use:

gpd publish images list phoneScreenshots --package com.example.app --locale en-US
gpd publish images upload icon icon.png --package com.example.app --locale en-US

Policy declarations not complete

Some policy/compliance items must be completed in Play Console UI. Confirm in the console if CLI operations pass but submission is blocked.

Notes

  • Use gpd publish edit validate before committing large changes.
  • Use --dry-run where available before destructive actions.