dartgenx #

A powerful and flexible Command Line Interface (CLI) tool for generating common Flutter/Dart boilerplate code directly into your project. Stop writing the same utility files over and over—let dartgenx handle the heavy lifting!

✨ Features #

dartgenx offers both direct command execution and an interactive mode to quickly scaffold necessary services and utilities.

• ApiClient Service: Creates an api_client.dart file with dio api calling setup.
• Assets Utility Generation: Creates an assets_utils.dart file with static paths for all resources in your assets folder.
• FCM Service Scaffold: Generates a standard fcm_service.dart for handling Firebase Cloud Messaging setup.
• Refresh Token Service: Scaffolds a dedicated service for managing token refresh logic.
• Local Storage Service: Creates either shared_preferences_service.dart or get_storage_service.dart to store data locally.
• Sqflite Service: Creates an sqflite_service.dart to store data locally.
• Pagination Utilities: Creates both a pagination_controller.dart and a reusable paging_list_view.dart widget.
• Bloc Classes: Creates a basic bloc folder structure with bloc.dart, state.dart and event.dart files with boilerplate prewritten code.
• Getx Classes: Creates a basic getx folder structure with controller.dart, bindings.dart and screens.dart files with boilerplate prewritten code.
• Interactive Mode: Use the dartgenx run command for a friendly menu-driven generation experience.

🚀 Installation #

1. Activate the Package #

Activate dartgenx globally using the Dart package manager. This makes the dartgenx command available anywhere on your system.

dart pub global activate dartgenx

2. Verify Installation #

Run the help command to confirm dartgenx is installed and working correctly.

dartgenx --help

👨‍💻 Usage #

There are two primary ways to use dartgenx: Direct Commands and the Interactive Run mode.

1. Interactive Mode (dartgenx run)

For generating multiple files at once or for a guided experience, use the run command.

dartgenx run

This will launch an interactive multi-select menu, allowing you to choose which services you want to generate.

? Select what you have to generate:

[ ] Generate ApiClient [ ] Generate AssetsUtils [ ] Generate FcmService [ ] Generate RefreshToken service [ ] Generate Local Storage service [ ] Generate SqfliteService [ ] Generate Pagination Service [ ] Generate BLoC Service [ ] Generate Getx Service [ ] Generate App icons

2. Direct Commands

Use these commands for quick, single-purpose generation.

General Help #

To see the list of all available commands:

dartgenx --help

OR #

dartgenx -h

General Version #

To see current installed version on your device:

dartgenx --version

OR #

dartgenx -v