Created with ❤️ by Rahul Verma

A powerful command-line tool for creating Flutter applications with BLoC architecture, clean code structure, and industry best practices. Generate production-ready Flutter projects in seconds!

• 🎯 Interactive Setup - Choose API client, modules, and packages
• 🏛️ Clean Architecture - Proper separation of concerns
• 🔄 BLoC State Management - Complete BLoC pattern implementation
• 🔐 Secure Storage - Encrypted token storage with session management
• 🌐 Network Layer - Dio/HTTP with comprehensive error handling
• 🧪 Testing Ready - Pre-configured testing infrastructure

• ➕ Smart Package Addition - Interactive package selection with descriptions
• 🏷️ Categorized Packages - Organized by functionality (State Management, UI, etc.)
• 💡 Usage Hints - Helpful import statements and usage tips
• 🔍 Popular Packages - Curated list of most-used Flutter packages

• 🏗️ Module Generation - Complete modules with BLoC, Repository, and Models
• 📱 Screen Templates - List, Detail, Form, and Basic screen types
• 🔄 Auto-Registration - Automatic service locator and routing updates
• 📝 CamelCase Support - Proper naming conventions throughout

Global Installation (Recommended):

dart pub global activate rj_blocx

Add to PATH: (if not already added)

# For macOS/Linux (Zsh)
echo 'export PATH="$PATH":"$HOME/.pub-cache/bin"' >> ~/.zshrc
source ~/.zshrc

# For macOS/Linux (Bash)
echo 'export PATH="$PATH":"$HOME/.pub-cache/bin"' >> ~/.bashrc
source ~/.bashrc

Verify Installation:

rj_blocx --version
# Should output: RJ BlocX CLI version 1.0.0 - Created by Rahul Verma

# Create a new Flutter project
rj_blocx create my_awesome_app

# Follow the interactive prompts:
# 🌐 API Client: Dio (recommended) or HTTP
# 📦 Additional Modules: Profile, Settings
# 🔧 Extra Packages: Hive, ImagePicker, Permissions

What gets generated:

my_awesome_app/
├── lib/
│   ├── app/                 # App configuration
│   │   ├── app_router.dart         # Navigation routing  
│   │   ├── service_locator.dart    # Dependency injection
│   │   └── bloc_observer.dart      # BLoC debugging
│   ├── core/                # Core functionality
│   │   ├── network/               # API client & services
│   │   ├── constants/             # App & API constants
│   │   ├── utils/                 # Utilities & helpers
│   │   └── errors/                # Error handling
│   ├── modules/             # Feature modules
│   │   ├── auth/                  # Authentication
│   │   │   ├── bloc/             # State management
│   │   │   ├── screens/          # Login/Register screens
│   │   │   ├── models/           # User models
│   │   │   └── repository/       # Auth repository
│   │   └── home/                  # Home dashboard
│   │       ├── bloc/             # Home state management
│   │       ├── screens/          # Home/Profile screens
│   │       └── repository/       # Home repository
│   └── main.dart           # App entry point
├── analysis_options.yaml   # Linting rules
└── README.md              # Project documentation

rj_blocx create <project_name>

Example:

rj_blocx create my_shopping_app

Interactive Features:

• 🌐 API Client Selection: Choose between Dio (advanced) or HTTP (simple)
• 📦 Module Selection: Add Profile, Settings, or other modules
• 🔧 Package Selection: Add commonly used packages like Hive, ImagePicker
• 📋 Configuration Summary: Review your choices before generation

Single Package:

rj_blocx add package <package_name>

Examples:

rj_blocx add package shared_preferences
rj_blocx add package cached_network_image
rj_blocx add package image_picker

Multiple Packages (Interactive):

rj_blocx add packages

Package Categories:

• 🔄 State Management: flutter_bloc, provider, riverpod
• 🌐 Networking: dio, http, retrofit
• 💾 Storage: shared_preferences, hive, sqflite
• 🎨 UI Components: cached_network_image, lottie, shimmer
• 🧭 Navigation: go_router, auto_route
• 📝 Forms: flutter_form_builder, form_builder_validators
• 📱 Device: image_picker, camera, geolocator, permission_handler
• 🛠️ Utils: intl, url_launcher, path_provider

Generate Module:

rj_blocx generate module <module_name>

Example:

rj_blocx generate module user_profile

Generates:

• 📁 Complete module structure
• 🔄 BLoC files (bloc, event, state)
• 📱 Customizable screens
• 💾 Repository with API integration
• 📊 Data models
• 🔧 Auto-registration in service locator

Generate Screen:

rj_blocx generate screen <screen_name>
rj_blocx generate page <page_name>    # Alias for screen

Examples:

rj_blocx generate screen product_details
rj_blocx generate page checkout_form

Screen Types:

• 📋 List Screen: Displays items with search, filter, and CRUD operations
• 📄 Detail Screen: Shows detailed item information with edit/delete options
• 📝 Form Screen: Input forms with validation and submission
• 📱 Basic Screen: Simple content screen with customizable layout

• ✅ Secure Login/Register with input validation
• ✅ Token Management with automatic refresh
• ✅ Session Persistence with encrypted storage
• ✅ Biometric Authentication support (optional)
• ✅ Password Reset flow
• ✅ Logout with complete cleanup

• ✅ Welcome Screen with user information
• ✅ Quick Actions grid layout
• ✅ Navigation to other modules
• ✅ Profile Management integration
• ✅ Settings access

• ✅ HTTP/Dio Client with interceptors
• ✅ Error Handling with user-friendly messages
• ✅ Request/Response Logging for debugging
• ✅ Token Injection for authenticated requests
• ✅ Retry Logic for failed requests
• ✅ Timeout Configuration with fallbacks

• ✅ Repository Pattern for data abstraction
• ✅ Either Pattern for error handling
• ✅ Model Classes with JSON serialization
• ✅ Caching Strategy (if Hive selected)
• ✅ Local Storage with flutter_secure_storage

• ✅ Material Design 3 components
• ✅ Responsive Layouts for different screen sizes
• ✅ Loading States with shimmer effects
• ✅ Error States with retry options
• ✅ Empty States with helpful messages
• ✅ Form Validation with real-time feedback

# 1. Create project
rj_blocx create my_app

# 2. Navigate to project
cd my_app

# 3. Install dependencies
flutter pub get

# 4. Run the app
flutter run

# 1. Generate new module
rj_blocx generate module products

# 2. Add required packages
rj_blocx add package sqflite
rj_blocx add packages  # Interactive selection

# 3. Generate specific screens
rj_blocx generate screen product_list
rj_blocx generate screen product_detail

# 4. Update API constants and routing
# (Follow the generated comments in code)

# Analyze code
flutter analyze

# Run tests
flutter test

# Format code
dart format .

# Generate coverage
flutter test --coverage

RJ BlocX CLI follows Clean Architecture principles:

• Screens: UI components and user interactions
• BLoC: State management and business logic
• Widgets: Reusable UI components

• Models: Data entities and business objects
• Repositories: Abstract data contracts
• Use Cases: Business logic operations

• Repositories: Concrete data implementations
• Data Sources: API clients and local storage
• Models: Data transfer objects

• Network: HTTP clients and API services
• Utils: Helper functions and utilities
• Constants: App-wide constants and configuration
• Errors: Error handling and exceptions

Update lib/core/constants/api_constants.dart:

class ApiConstants {
  static const String baseUrl = 'https://your-api.com';
  static const String apiVersion = '/v1';

  // Add your endpoints
  static const String products = '/products';
  static const String orders = '/orders';
}

Modify lib/core/theme/app_theme.dart:

static ThemeData lightTheme = ThemeData(
  colorScheme: ColorScheme.fromSeed(
    seedColor: Colors.blue, // Your brand color
  ),
  // Customize other theme properties
);

Add routes in lib/app/app_router.dart:

case AppConstants.productListRoute:
return MaterialPageRoute(builder: (_)
=>
const
ProductListScreen
(
)
);

Command not found:

# Ensure PATH is set correctly
echo $PATH | grep pub-cache

# If not found, add to your shell config
echo 'export PATH="$PATH":"$HOME/.pub-cache/bin"' >> ~/.zshrc
source ~/.zshrc

Flutter not found:

# Verify Flutter installation
flutter doctor

# Install if needed: https://flutter.dev/docs/get-started/install

Permission denied:

# Fix executable permissions
chmod +x ~/.pub-cache/bin/rj_blocx

Project creation fails:

# Ensure you have write permissions
# Run in a directory you own
cd ~/Projects
rj_blocx create my_app

We welcome contributions! Here's how to help:

1. 🍴 Fork the repository
2. 🌿 Create your feature branch (git checkout -b feature/amazing-feature)
3. ✅ Commit your changes (git commit -m 'Add amazing feature')
4. 📤 Push to the branch (git push origin feature/amazing-feature)
5. 🔀 Open a Pull Request

# Clone the repository
git clone https://github.com/RahulDev-flutter/blocx_cli.git
cd blocx_cli

# Install dependencies
dart pub get

# Run tests
dart test

# Test locally
dart pub global activate --source path .

Rahul Verma - Flutter Developer & Tech Enthusiast

• 🔗 GitHub: @RahulDev-flutter
• 💼 LinkedIn: Rahul Verma
• 📧 Email: [email protected]
• 🌐 Portfolio: rahulverma.dev

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

• Flutter Team for the amazing framework
• BLoC Library for excellent state management
• Community for feedback and contributions

• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📧 Email: [email protected]

Made with ❤️ by Rahul Verma for the Flutter community

Transform your Flutter development workflow with RJ BlocX CLI! 🚀