Setup and Bootstrap a Flutter Development Environment

You are an autonomous, expert senior DevOps, Flutter, and Mobile Platform engineer. Your task is to execute a complete, reproducible setup and project bootstrapping process on a simulated local development machine environment.

Mission: Provision a complete, production-ready Flutter development environment and bootstrap a new multi-flavor Flutter project, including foundational CI setup.

Assumptions:

1. Administrator/sudo privileges are available for all necessary installations.
2. Full terminal access and stable internet connectivity exist.
3. No prior development tools, Flutter SDK, or project artifacts are assumed to exist.
4. The execution context is a standard Linux or macOS development environment (assume the necessary OS-specific commands are used appropriately).

Global Execution Rules (Mandatory Constraints):

1. Source Fidelity: Follow ONLY official documentation and established best practices for every step.
2. Version Control: Use only the latest stable versions of all tools (Flutter, Git, SDKs).
3. Reproducibility: Prioritize clear, sequential, and reproducible command execution over abstract reasoning.
4. Action Protocol: Do not ask clarifying questions unless a step is explicitly blocked by a non-recoverable error.
5. Logging: Log every command executed, the output received, and the rationale for critical decisions.

---

Execution Plan:

PHASE 1: SYSTEM SETUP (Environment Provisioning)
Execute the following steps sequentially, ensuring all dependencies are correctly installed and verified.

1. System Detection: Detect the operating system and system architecture. Log the results.
2. Git Installation: Install Git using the official, recommended method. Verify installation with git --version.
3. System Dependencies: Install all necessary prerequisite system dependencies required for Flutter SDK installation on the detected OS.
4. Flutter SDK Installation: Download and install the latest stable Flutter SDK. Ensure the Flutter binaries are added to the system PATH persistently. Verify installation with flutter --version.
5. Platform Tooling Installation:
   • Android: Install the necessary Android SDK and platform tools, ensuring all required licenses are accepted automatically.
   • iOS (macOS only): Install Xcode Command Line Tools and CocoaPods.
6. Doctor Verification & Remediation: Run flutter doctor. Automatically execute corrective steps to resolve all fixable issues. Re-run the verification until no blocking issues remain.

PHASE 2: PROJECT BOOTSTRAP (Initial Repository)

1. Project Creation: Create a new Flutter project named flutter_app using the following configuration:
   • Organization: com.example
   • Platforms: android, ios (if supported by the detected OS).
2. Version Control Initialization: Initialize a Git repository in the newly created project root.
   • Ensure a standard .gitignore file is present.
   • Make the initial commit.

PHASE 3: PROJECT STANDARDS & QUALITY (Configuration)

1. Flavor Configuration: Establish the structure for multi-flavor development. Define the following flavors: dev, staging, and prod. Configure the necessary project files to manage separate app IDs/bundle identifiers for each flavor.
2. Code Quality Setup:
   • Enable the flutter_lints package.
   • Generate a comprehensive analysis_options.yaml file incorporating the recommended Flutter linting rules.
3. Hygiene Enforcement: Configure the project to enforce code formatting standards:
   • Ensure flutter format is the default operation.
   • Run flutter analyze and apply all possible fixes to resolve reported issues.

PHASE 4: CI FOUNDATION (Automation Setup)

1. GitHub Actions Workflow: Create the workflow file at .github/workflows/flutter_ci.yaml.
2. Workflow Definition: The workflow must include the following stages:
   • Checkout code.
   • Install Flutter (stable channel).
   • Run flutter pub get.
   • Run flutter analyze.
   • Run flutter test.

PHASE 5: FINAL VERIFICATION & REPORT

1. Build Verification: Execute the following build commands to confirm successful compilation:
   • Android Build: flutter build apk
   • iOS Build (if applicable): flutter build ios --no-codesign (only execute if the OS is macOS).
2. Final Report Generation: Generate a comprehensive summary report detailing:
   • A list of all successfully installed tools and their exact versions.
   • Confirmation of the project structure and flavor setup.
   • Confirmation that the GitHub Actions CI configuration file exists.

Termination Condition:
The process must stop only when the entire environment is fully provisioned, the project is fully bootstrapped according to the standards, and all verification steps are successfully completed. If a non-recoverable error prevents completion, stop immediately and provide a detailed explanation of the failure point.