Remove

📝 Description

The remove command safely removes packages from your Flutter project's pubspec.yaml. It handles dependency cleanup, version conflicts resolution, and ensures your project remains in a consistent state.

⚙️ Usage

gexd remove [package_name] [options]
gexd remove [package_name] [package_name2] [options]

📋 Basic Examples:

# Remove a specific package
gexd remove http

# Remove multiple packages
gexd remove http dio shared_preferences

# Preview removal without applying changes
gexd remove http --dry-run

# Remove dev dependencies
gexd remove --dev mockito test_coverage

# Interactive removal (select from list)
gexd remove

🚩 Flags

Flag
Description

--dry-run

Show what would be removed without making changes

--dev

Remove from dev dependencies only

--all-dev

Remove all dev dependencies

--unused

Remove unused dependencies automatically

--force

Skip confirmation prompts

🎯 Interactive Mode

When run without package name, remove enters interactive mode:

  1. 📋 List current dependencies (regular and dev)

  2. ✅ Select packages to remove

  3. 🔍 Show dependency usage analysis

  4. ⚠️ Warn about breaking changes

  5. 🗑️ Remove safely

📊 Examples by Use Case:

Clean Unused Packages:

# Analyze and remove unused dependencies
gexd remove --unused

# Preview unused packages
gexd remove --unused --dry-run

Remove Development Tools:

# Remove specific dev dependencies
gexd remove --dev test mockito flutter_test

# Remove all dev dependencies
gexd remove --all-dev

Bulk Removal:

# Remove multiple related packages
gexd remove dio http chopper retrofit

# Remove with force (no confirmation)
gexd remove old_package --force

✅ What It Does:

  1. 🔍 Dependency Analysis - Checks if package is actually used

  2. ⚠️ Impact Assessment - Shows what might break

  3. 📝 pubspec.yaml Update - Removes dependency entries

  4. 🧹 Lock File Cleanup - Updates pubspec.lock

  5. ⬇️ Dependency Resolution - Runs dart pub get

  6. 📋 Import Cleanup - Suggests removing unused imports

🛡️ Safety Features:

  • 🔒 Usage Detection: Warns if package is used in code

  • 📊 Dependency Tree: Shows dependent packages

  • ✅ Confirmation Prompts: Asks before removal

  • 🔄 Rollback Option: Can undo changes

  • ⚠️ Breaking Change Alerts: Warns about major version changes

⚠️ Notes:

  • 🔍 Code Scanning: Analyzes imports in your project

  • 🏗️ Build Verification: Ensures project still compiles

  • 📦 Transitive Dependencies: Handles nested dependency removal

  • 🎯 Selective Removal: Can target specific dependency types

Generated automatically by gexd_doc

PreviousAddNextUpgrade

Last updated