Flutter & Dart Commands

A VS Code extension that supercharges your Flutter and Dart development workflow by providing quick access to Flutter and Dart commands directly from VS Code.

Features

This extension enhances your Flutter and Dart development experience with:

Command Palette Integration

• Access a comprehensive set of Flutter and Dart commands through a dedicated command palette
• Commands are organized by category for easy navigation
• Recently used commands are remembered for quick access

Over 180 Built-in Commands across Categories:

• Run & Debug: Run apps in different modes (debug, profile, release), attach to devices, run with specific configurations
• Build: Build different output formats (APK, iOS, web, etc.) with custom configurations
• Android/Gradle: Gradle tasks like signingReport, clean, assembleDebug, lint, and more
• iOS/Xcode: Pod install, Xcode commands, simulator management
• Package Management: Flutter/Dart pub commands (get, upgrade, add, remove, outdated, etc.)
• Testing & Analysis: Test, analyze, format, coverage reports
• Code Generation: Build runner commands, localization, splash screen, app icons
• Utility: Clean, doctor, devices, version management, emulators

Custom Commands

• Create your own Flutter and Dart commands with a friendly interface
• Add custom arguments with validation and prompting
• Organize custom commands into categories
• Manage (edit/delete) your custom commands

Smart Execution

• Commands execute in the appropriate directory context (project root, android, or ios folder)
• Dedicated terminal for Flutter/Dart commands
• Terminal reuse for consecutive commands

Command Configuration

• Interactive configuration for complex commands
• Support for commands with arguments and options
• Input-aware prompts with command-specific placeholders and examples
• Automatic required-input prompts for commands such as flavor and device selection

Installation

1. Open VS Code
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "Flutter & Dart Commands"
4. Click Install

Requirements

• Flutter SDK installed and available in your PATH
• Dart SDK installed and available in your PATH
• VS Code

Usage

Main Command Palette

1. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS)
2. Type "Run Flutter/Dart Command" or select it from the list
3. Choose a command from the categorized list
4. For commands that require values, follow the detail hint and enter the requested input

Custom Commands

1. Add custom commands through the "Add Custom Command" option
2. Provide command details, arguments, and configuration
3. Access your custom commands alongside built-in ones

Extension Settings

This extension contributes the following settings:

• flutterDartCommands.showCommandsInEditor: Show commands in the editor context menu
• flutterDartCommands.customCommands: Stores your custom commands (managed by the extension)

Command Categories

Run & Debug Commands

• Flutter Run (various configurations)
• Flutter Attach
• Device-specific commands with required device-id prompts
• Web, flavor, target-file, and dart-define configurations

Build Commands

• Platform-specific builds (APK, iOS, web, etc.)
• Build configuration options
• Flavor support with required input prompts
• Export options, base-href, target-platform, and dart-define variants

Android/Gradle Commands

• Gradle tasks and configurations
• Android-specific build commands
• Signing and reporting

iOS/Xcode Commands

• Pod management
• Xcode operations
• Simulator commands

Package Management

• Package installation and updates
• Dependency management
• Add/remove/global package commands with guided input

Testing & Analysis

• Run tests with various options
• Code analysis
• Format code
• Generate coverage reports

Code Generation

• Build runner operations
• Generate localization
• Create splash screens and icons

Utility

• Device management
• Flutter/Dart version commands
• Environment configuration and platform-specific precache options

Troubleshooting

Common Issues

1. Commands not working: Make sure Flutter and Dart SDKs are properly installed and in your PATH
2. Android commands failing: Ensure you have a valid Flutter project with an Android folder
3. iOS commands failing: Ensure you have a valid Flutter project with an iOS folder and required iOS development tools

License

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

Made with ❤️ by Taha Darwish