Skip to content

README.md

Latest commit

 

History

History
81 lines (55 loc) · 1.54 KB

README.md

File metadata and controls

81 lines (55 loc) · 1.54 KB

fro

CI pub.dev

Dart CLI for managing Flutter app versions, build numbers, and releases across environments.

Install

dart pub global activate fro

Usage

# Show current version from pubspec.yaml
fro check

# Compare pubspec version against the latest git tag for an environment
fro check --env=prod

# Bump version and create a git tag
fro bump --env=prod --strategy=patch   # 1.2.3+45 → 1.2.4+46
fro bump --env=stg  --strategy=minor   # 1.2.3+45 → 1.3.0+46

# Full release (bump + tag + optional store upload)
fro release --env=prod
fro release --env=prod --ci            # non-interactive, for CI pipelines

Git tag format

prod-v1.2.3+45
stg-v1.2.3+78
dev-v0.1.0+12

Build numbers are independent per environment and never reset to zero.

Config (fro.yaml)

Place this at the root of your Flutter project:

environments:
  - name: prod
    track: production
  - name: stg
    track: beta
  - name: dev
    track: internal

Credentials

Never pass credentials via CLI args. Use environment variables:

export FRO_PLAYSTORE_KEY_PATH=/path/to/key.json
export FRO_APPSTORE_PRIVATE_KEY=/path/to/key.p8

Contributing

See CONTRIBUTING.md. All contributions require:

  • dart analyze — clean
  • dart format — applied
  • Tests for new behaviour