Scripts Runner #

A development scripts management tool for Dart and Flutter projects. Automatically sets up your development environment with essential tools, configurations, and best practices.

Features #

🚀 One-command setup - Get your development environment ready instantly
📝 Smart configuration - Automatically copies essential config files
🔧 VS Code integration - Installs recommended extensions and settings
📦 Offline ready - Bootstrap scripts for local usage
⚡ Cross-platform - Works on macOS, Linux, and Windows

Quick Start #

Installation #

dart pub global activate scripts_runner

Or add to your project:

dart pub add dev:scripts_runner

Usage #

# Setup complete development environment
dart run scripts_runner post-install

# Install VS Code extensions
dart run scripts_runner install-extensions

# Copy scripts for offline usage
dart run scripts_runner bootstrap

# Show help
dart run scripts_runner --help

Commands #

What Gets Set Up #

Development Tools #

• FVM - Flutter Version Management
• Flutter dependencies - Essential dev packages (husky, lint_staged, etc.)
• lint_staged - Automatic code formatting and analysis on git commit

VS Code Configuration #

• Settings - Optimized workspace settings for Dart/Flutter
• Extensions - Recommended extensions for better development experience
• Launch configs - Debug configurations
• Code snippets - Useful Dart/Flutter snippets

Git Hooks #

• Husky - Git hooks configuration
• Commit lint - Conventional commit message validation
• Pre-commit hooks - Code formatting and linting

Example #

# Clone your Flutter project
git clone https://iplayabc.coding.net/public/tushuguanbiaozhunjiejuefangan/scripts_runner/git
cd scripts_runner

# Run scripts_runner setup
dart pub add dev:scripts_runner
dart run scripts_runner post-install

# Your development environment is now ready! 🎉

Configuration Files #

The tool automatically manages these configuration files:

.husky.yaml              # Git hooks configuration
.vscode/
  ├── settings.json      # VS Code workspace settings
  ├── launch.json        # Debug configurations
  ├── extensions.json    # Recommended extensions
  └── dart.code-snippets # Code snippets

Requirements #

• Dart SDK 3.0 or higher
• Git (for git hooks functionality)
• VS Code (optional, for extension installation)

Contributing #

We welcome contributions! Please see our Contributing Guide for details.

Development Setup #

git clone https://iplayabc.coding.net/public/tushuguanbiaozhunjiejuefangan/scripts_runner/git
cd scripts_runner
dart pub get
dart run scripts_runner bootstrap

Made with ❤️ for the Dart and Flutter community