Scripts Runner

Dart License: MIT pub package

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

Command Description
post-install Complete development environment setup (FVM, VS Code configs, Git hooks, etc.)
install-extensions Install recommended VS Code extensions
bootstrap Copy all configs and scripts to local project for offline use

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

Libraries

scripts_runner