fdev 0.1.6

Ultimate Flutter developer tools CLI. Streamline build_runner, Swagger/OpenAPI code generator, Android signing keystores, CocoaPods updater, and developer productivity workflows.

fdev

fdev is a local Dart CLI for repeated Flutter development tasks:

• run build_runner with --delete-conflicting-outputs
• run flutter clean followed by flutter pub get
• build APKs with flavor, target, build mode, defines, and split ABI flags
• build Android app bundles with flavor, target, build mode, and defines
• build iOS apps with flavor, target, build mode, and defines
• generate launcher icons via flutter_launcher_icons
• generate native splash screens via flutter_native_splash
• select dev/stage/prod .env files into .env
• write fastlane-style APK metadata and changelogs from the pubspec version
• run the iOS pod update workflow
• generate Android upload keystores and show SHA fingerprints
• generate plain Dart API response models from Swagger/OpenAPI JSON
• optional --copy-with on generated Swagger models
• watch a local Swagger file and regenerate models on change
• one-click Graphify + Caveman setup for Cursor, Claude Code, Codex, and Antigravity
• check local Dart/Flutter setup

This package is intentionally dependency-free. The generated API models also avoid external dependencies and include manual fromJson and toJson methods.

Installation

You can install fdev globally from pub.dev using the Dart SDK:

dart pub global activate fdev

OS-Specific Path Setup

To run fdev from any terminal, Dart's global bin directory must be added to your system's PATH:

Operating System	Path to Add	How to Configure
macOS / Linux	$HOME/.pub-cache/bin	Add export PATH="$PATH:$HOME/.pub-cache/bin" to ~/.zshrc or ~/.bashrc and run source ~/.zshrc.
Windows	%USERPROFILE%\.pub-cache\bin or %APPDATA%\Pub\Cache\bin	Add the path to your User Environment Variables under Path using the System Settings GUI.

Verify the installation:

fdev version
fdev doctor

OS Compatibility Table

Here is the compatibility matrix for fdev features across operating systems:

Feature / Command	macOS	Windows	Linux	Note
fdev doctor	✅	✅	✅	Check Dart/Flutter/fdev environment
fdev gen	✅	✅	✅	Run build_runner code generator
fdev clean	✅	✅	✅	Clean project build cache & fetch packages
fdev apk	✅	✅	✅	Android APK builds
fdev appbundle	✅	✅	✅	Android App Bundle builds
fdev ios	✅	❌	❌	iOS builds require macOS + Xcode
fdev icons	✅	✅	✅	Launcher icon generation
fdev splash	✅	✅	✅	Native splash generation
fdev env	✅	✅	✅	.env file selection
fdev release-notes	✅	✅	✅	APK metadata and changelog
fdev signapk	✅	✅	✅	Generate Android signing keys
fdev sha	✅	✅	✅	Show keystore SHA fingerprints
fdev swagger	✅	✅	✅	Swagger/OpenAPI model generator
fdev init	✅	✅	✅	Graphify + Caveman multi-agent project setup
fdev upgrade	✅	✅	✅	Self-upgrade CLI to the latest version
fdev version	✅	✅	✅	Print active CLI version
fdev pod update	✅	❌	❌	CocoaPods is macOS-only

Local Development / Activation

If you are developing this tool locally on this laptop, navigate to the project directory and run:

dart pub global activate --source path .

Commands

Run Build Runner

From a Flutter project root:

fdev gen

This runs:

dart run build_runner build --delete-conflicting-outputs

Watch mode:

fdev gen --watch

Pass extra arguments after --:

fdev gen -- --build-filter="lib/**"

Clean And Get Packages

From a Flutter project root:

fdev clean

This runs:

flutter clean
flutter pub get

Build APK

Default release build:

fdev apk

With flavor:

fdev apk dev

With flavor and target:

fdev apk --flavor dev --target lib/main_dev.dart

With split ABI and defines:

fdev apk prod -t lib/main_prod.dart --split-per-abi --dart-define API_ENV=prod

Debug/profile:

fdev apk dev --debug
fdev apk dev --profile

Build App Bundle

Default release build:

fdev appbundle

With flavor and target:

fdev appbundle --flavor dev --target lib/main_dev.dart

With defines:

fdev appbundle prod -t lib/main_prod.dart --dart-define API_ENV=prod

Debug/profile:

fdev appbundle dev --debug
fdev appbundle dev --profile

Build iOS App

Default release build:

fdev ios

With flavor and target:

fdev ios --flavor dev --target lib/main_dev.dart

With defines:

fdev ios prod -t lib/main_prod.dart --dart-define API_ENV=prod

Debug/profile:

fdev ios dev --debug
fdev ios dev --profile

iOS builds require macOS with Xcode installed.

Generate Launcher Icons

From a Flutter project root (after adding flutter_launcher_icons as a dev_dependency):

fdev icons

With a custom config file:

fdev icons -f flutter_launcher_icons.yaml

With a web output prefix:

fdev icons -p public/

Generate Native Splash

From a Flutter project root (after adding flutter_native_splash as a dev_dependency):

fdev splash

For a flavor:

fdev splash --flavor dev

Remove the splash and restore defaults:

fdev splash --remove --flavor dev

Select Environment File

From a Flutter project root:

fdev env dev

This writes .env from .env.dev (or .env_dev). It also looks in env/, envs/, and config/.

List available environments:

fdev env --list

Print --dart-define flags for the selected environment:

fdev env prod --flutter-define

Write to a custom output path:

fdev env stage -o .env.local

Write Release Notes

From a Flutter project root:

fdev release-notes --notes "Fix login bug"

This reads version: <name>+<build> from pubspec.yaml and writes a fastlane changelog to fastlane/metadata/android/en-US/changelogs/<build>.txt.

Override version and build number:

fdev release-notes --version 1.2.3 --build-number 4

Custom output directory:

fdev release-notes -o fastlane/metadata/android/en-GB --notes "Bug fixes"

If --notes is omitted, fdev reads RELEASE_NOTES.md, then falls back to Release <version>.

Update iOS Pods

From a Flutter project root:

fdev pod update

This runs:

flutter clean
flutter pub get
cd ios && pod update

The short alias also works:

fdev pod-update

Generate Android Signing Keystore

From a Flutter project root:

fdev signapk

The CLI asks for:

• JKS file name
• key alias
• store password
• key password
• certificate owner name

It creates:

android/app/keystore.jks
android/app/keystore.properties

Then it prints SHA1 and SHA256.

Custom file and alias:

fdev signapk --file upload-keystore.jks --alias upload

The generated keystore.properties contains:

storePassword=...
keyPassword=...
keyAlias=upload
storeFile=keystore.jks

Keep the keystore and signing passwords private.

Show Android Keystore SHA

From a Flutter project root:

fdev sha

The CLI asks for the JKS file name and prints SHA1/SHA256. If android/app/keystore.properties exists, it reuses the stored file name, alias, and password.

Non-interactive:

fdev sha --file keystore.jks
fdev keystore-sha --file android/app/upload-keystore.jks --alias upload

Generate Models From Swagger

From a Flutter project root:

fdev swagger

The CLI asks for the Swagger/OpenAPI JSON URL and writes:

lib/models/api_models.dart

Non-interactive:

fdev swagger --url https://example.com/swagger.json --out lib/data/models/api_models.dart

From a local JSON file:

fdev swagger --file swagger.json --out lib/data/models/api_models.dart

Generate a copyWith method for each model:

fdev swagger --file swagger.json --out lib/data/models/api_models.dart --copy-with

Generate models for one endpoint only (request/response + nested $refs):

fdev swagger --file swagger.json \
  --path /users/{id} --method get \
  --out lib/models/user_detail.dart \
  --copy-with

Or by operationId:

fdev swagger --url https://example.com/openapi.json \
  --operation-id getUserById \
  --out lib/models/get_user.dart

Watch a local Swagger file and regenerate on change:

fdev swagger --file swagger.json --watch

With a custom poll interval (seconds):

fdev swagger --file swagger.json --watch --interval 1

The generator reads:

• OpenAPI 3 components.schemas
• Swagger 2 definitions
• inline JSON response schemas under paths
• plain sample JSON objects when the input is not an OpenAPI document

Generated models follow the Swagger/OpenAPI contract:

• fields listed in a schema's required array become required constructor parameters
• required fields are non-nullable unless the property is marked nullable
• optional fields stay nullable because the response may omit them
• nullable: true, x-nullable: true, type: ["...", "null"], and oneOf/anyOf null variants are treated as nullable

Init (Graphify + Caveman)

One-click project setup for Graphify and the Caveman skill across AI coding agents.

Default agents: Cursor, Claude Code, Codex, and Antigravity.

fdev init

Install for a subset only:

fdev init --agents cursor,codex
fdev init --agents claude-code,antigravity

Requires graphify (e.g. pipx install graphifyy) and npx on PATH. Missing tools print warnings and the rest of the setup continues.

Updating & Upgrading

How to Upgrade

If you installed fdev from pub.dev, you can easily update it to the latest version by running:

fdev upgrade

Alternatively, you can re-run the activation command:

dart pub global activate fdev

Developing & Publishing Updates

1. Modify Code: Edit files under lib/src/; add command implementations in the relevant lib/src/cli/*_command*.dart file.
2. Version Bump:
   • Update version in pubspec.yaml.
   • Update cliVersion in lib/src/cli/version.dart.
   • Document changes in CHANGELOG.md.
3. Format & Analyze:

   dart format .
   dart analyze
   

4. Local Activation Test:

   dart pub global activate --source path .
   

5. Publish to pub.dev:
   • Run dry-run checks:

     dart pub publish --dry-run
     

   • Publish to pub.dev:

     dart pub publish
     

Recommended Future Features

• fdev run to launch a flavor/target on a connected device
• fdev test to run widget and unit tests with coverage
• fdev doctor checks for Xcode, CocoaPods, and Android SDK versions