Scripts Runner #

Scripts Runner is a development scripts management tool designed for Dart and Flutter projects. It automates development environment setup to boost team productivity and maintain consistency across projects.

🔥 Key Features #

One-Command Setup #

Instant Bootstrap: Complete development environment setup with a single command Smart configuration: Automatically manages essential configuration files Cross-platform: Works seamlessly on macOS, Linux, and Windows

Development Tools Integration #

FVM Management: Flutter Version Management setup VS Code Integration: Auto-installs recommended extensions and configurations Git Hooks: Automated code quality checks and commit validation

✨ Quick Start #

Global Installation #

# Install globally
dart pub global activate scripts_runner

# Run setup
dart pub global run scripts_runner post-install --force

Project Dependency #

# Add to your project
dart pub add dev:scripts_runner

# Run setup
dart run scripts_runner post-install --force

Available Commands #

Configuration Files #

Automatically manages these configuration files:

analysis_options.yaml
commitlint.yaml
.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

🚀 Benefits for Teams #

Developer Experience #

• Reduced Setup Time: From hours to minutes for new project onboarding
• Consistency: Everyone works with the same tools and configurations
• Quality Assurance: Automated code formatting and linting

Project Maintenance #

• Standardized Workflows: Consistent development practices across projects
• Easy Updates: Centralized configuration management
• Offline Capability: Bootstrap feature for air-gapped environments

💡 What Gets Set Up #

Development Tools #

• Flutter Version Management (FVM)
• Essential dev dependencies (husky, lint_staged, etc.)
• Code quality tools and linters

VS Code Configuration #

• Optimized settings for Dart/Flutter development
• Recommended extensions for better DX
• Useful code snippets

Git Workflow #

• Pre-commit hooks for automatic code formatting and analysis
• Commit message validation (conventional commits)

🎨 Contribution #

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

Made with ❤️ for the Dart and Flutter community