gplay-release-flow

Automates Google Play releases, track promotions, and staged rollouts using gplay CLI commands.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/lettucebo/Skills --skill gplay-release-flow-lettucebo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gplay-release-flow
Source: https://github.com/lettucebo/Skills/tree/main/skills/google-play-console-cli/gplay-release-flow
Command: npx skills add https://github.com/lettucebo/Skills --skill gplay-release-flow-lettucebo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Publishing Android builds to Google Play involves repetitive manual steps in the Play Console: uploading AAB files, configuring tracks, writing release notes, and managing staged rollouts. This Skill turns those steps into scripted gplay CLI workflows that can run locally or in CI/CD pipelines. ## Core Features & Use Cases - End-to-End Releases: Upload AAB/APK builds to internal, beta, or production tracks with a single gplay release command, including listings, screenshots, and multi-locale release notes. - Track Promotion & Staged Rollouts: Promote builds between tracks and control rollout fractions (10%, 50%, 100%) with update, halt, resume, and complete commands. - Safe Validation: Preview any release with --dry-run and follow a pre-release checklist covering version codes, signing, and permissions. - Use Case: An Android team wants to ship a new version: release to internal on week one, promote to beta on week two, then promote to production at 10% rollout and gradually increase to 100% over several days, all via terminal commands. ## Quick Start Ask the AI to release your signed app-release.aab to the Google Play internal track using the gplay CLI with your app's package name.

Frequently Asked Questions about gplay-release-flow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I release an Android app to Google Play from the command line?▼

Use the gplay release command with your package name, target track, and AAB file path. For example, gplay release --package com.example.app --track internal --bundle app-release.aab uploads the build to the internal track in one step.

How to promote a build from beta to production on Google Play?▼

Run gplay promote with --from beta --to production and your package name. You can add --rollout 0.25 to start a staged rollout at 25% instead of releasing to all users immediately.

Can I do a staged rollout on Google Play via CLI?▼

Yes, pass --rollout with a fraction between 0.0 and 1.0 to gplay release or promote. Use gplay rollout update to increase the percentage, and halt, resume, or complete to control the rollout lifecycle.

Does gplay release support multi-locale release notes?▼

Yes, the --release-notes flag accepts a JSON array of {language, text} entries for multiple locales, plain text auto-assigned to en-US, or an @file path pointing to either format.

How do I validate a Google Play release before publishing?▼

Add --dry-run to the gplay release command to preview the release without executing it. Also verify the version code is incremented, the AAB is signed correctly, and the service account has Release Manager permission.

What permissions are needed for gplay CLI releases?▼

The service account needs Release Manager permission in Play Console. Authenticate with gplay auth login or set the GPLAY_SERVICE_ACCOUNT environment variable, which is the recommended approach for CI/CD pipelines.