Publish #

Publish is the ultimate CLI tool for Flutter developers. It automates the tedious parts of app configuration, release management, and asset generation, letting you focus on writing code. From "Zero to Hero" project setup to seamless Play Store publishing preparation, publish has you covered.

Features #

• 🚀 Interactive Setup: Wizard-style setup for new projects (init).
• 🔀 Multi-Config Support: Manage multiple environments (dev, staging, prod) with unique App Names, Package IDs, Icons, and Splash Screens.
• 🎨 Asset Management: Generate icons (Android/iOS) and splash screens from a single file. Preserves assets per configuration!
• 🏗️ Release Workflow: Automate version bumps and changelog updates.
• ⚕️ Project Doctor: Diagnose and fix configuration issues (pubspec, gradle, manifest).
• 🔐 Android Signing: Auto-generate keystores and modify build.gradle safely.
• 📦 Import/Export: Share configurations across teams with ease.

Installation #

Activate the package globally from pub.dev:

flutter pub global activate publish

You can now use the publish command anywhere in your terminal.

Quick Start #

Recommended Workflow #

For New Projects:

1. Analyze your project first:

   publish doctor
   

2. Quick Setup with the interactive wizard:

   publish init
   

3. Verify everything is configured:

   publish doctor
   

For Existing Projects:

1. Run publish doctor to identify issues.
2. Fix issues using suggested commands.
3. Create configurations for different environments (e.g., staging, prod).

🔥 Multi-Configuration System #

publish introduces a powerful configuration system that lets you switch between different app profiles instantly. Each profile maintains its own:

• App Name & Package ID
• Keystore & Signing Credentials
• App Icons (Android & iOS)
• Splash Screen
• Version Suffix (e.g., -beta)
• App Version (preserves pubspec.yaml version)

🛡 This is "Data Preservation" #

When you create profiles or build legacy setups, publish ensures complete data safety:

1. Version Preservation: Switching profiles automatically updates the version in pubspec.yaml to match that profile's last state.
2. Asset Preservation: Your android and ios icons and splash screens are backed up per-profile. Switching restores them instantly.
3. Legacy Intelligence: If you have a custom properties file (e.g., android/secrets.props) with extra variables (like API_KEY), publish detects and preserves them alongside your signing keys. Nothing is lost!

Managing Configs #

Building with Configs #

You can build with a specific configuration without permanently switching to it:

publish build android --config staging

This temporary applies the staging profile (icons, ids, signing), builds the app, and reverts to your previous state.

Detailed Command Reference #

Core Commands #

Build & Sign #

Assets #

Version Management #

Maintenance #

Advanced Usage #

Gradle Format Support #

publish intelligently detects and handles both Groovy (build.gradle) and Kotlin DSL (build.gradle.kts) formats.

iOS Support #

The splash command modifies the LaunchScreen.storyboard directly using color transformation logic to ensure your splash screen looks perfect on iOS devices.

Contributing #

We welcome contributions!

1. Star the repo on GitHub.
2. Open an issue for bugs or feature requests.
3. Submit a PR to help improve the tool.

Author #

Available as Senior App Developer

Follow on GitHub for more open source repos like this.

License #

This project is licensed under the MIT License - see the LICENSE file for details.