Menu
Set up a macOS environment for Flutter development
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Configure your Flutter app to support assistive technologies like Screen Readers
Add animated effects to your Flutter app
Measure and reduce the size of the Flutter app bundle, APK, or IPA
Use the Flutter team's recommended app architecture
Execute long-running tasks in a background thread in Flutter
Adding a Home Screen widget to your Flutter App
| name | flutter-environment-setup-macos |
| description | Set up a macOS environment for Flutter development |
| metadata | {"model":"models/gemini-3.1-pro-preview","last_modified":"Thu, 26 Feb 2026 23:40:36 GMT"} |
Configures a macOS development environment for building, running, and deploying Flutter applications. Validates tooling dependencies including Xcode and CocoaPods, and ensures the environment passes Flutter's diagnostic checks for macOS desktop development. Assumes the host operating system is macOS and the user has administrative privileges.
Verify Flutter Installation Check if Flutter is installed and accessible in the current environment.
flutter --version
Decision Logic:
Verify Xcode Installation Ensure Xcode is installed on the macOS system.
xcodebuild -version
Decision Logic:
Configure Xcode Command-Line Tools Link the Xcode command-line tools to the installed version of Xcode and run the first-launch setup. STOP AND ASK THE USER: "I need to configure Xcode command-line tools. This requires administrative privileges. Please run the following command in your terminal and confirm when done:"
sudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'
(Note: If the user installed Xcode in a non-standard directory, instruct them to replace /Applications/Xcode.app with their custom path).
Accept Xcode Licenses The Xcode license agreements must be accepted before compilation can occur. STOP AND ASK THE USER: "Please run the following command to review and accept the Xcode license agreements:"
sudo xcodebuild -license
Install CocoaPods CocoaPods is required for Flutter plugins that utilize native macOS code. Check if CocoaPods is installed:
pod --version
Decision Logic:
sudo gem install cocoapods
Validate Setup (Validate-and-Fix Loop) Run the Flutter diagnostic tool to check for any remaining macOS toolchain issues.
flutter doctor -v
Decision Logic:
flutter doctor -v.Verify Device Availability Ensure Flutter can detect the macOS desktop as a valid deployment target.
flutter devices
Verify that at least one entry in the output has "macos" listed as the platform. If it is missing, instruct the user to enable macOS desktop support:
flutter config --enable-macos-desktop
sudo commands automatically; always pause and provide the exact command for the user to execute.flutter doctor Xcode section is completely clear of errors before considering the skill complete.