How to Setup Flutter on MacOS ( 2026 Guide )

Get the Flutter SDK running on your Mac and pass flutter doctor clean.

Why it matters

macOS is the only platform that can build for both iOS and Android from one machine
Google's VS Code extension installer handles most of this automatically now, so manual PATH editing is mostly optional
flutter doctor is the single command that tells you exactly what's still broken

Install VS Code, then search "Flutter" in the Extensions panel and install it
On first Flutter command, VS Code prompts to download the SDK for you — no manual PATH edit needed

Install Flutter Extension

Check your chip first: Apple menu → About This Mac → note Apple Silicon vs Intel
Download the matching SDK zip from Flutter's site
Extract to ~/develop/ (or wherever you keep dev tools)
Add to PATH: open ~/.zshrc, add export PATH="$PATH:$HOME/develop/flutter/bin", then source ~/.zshrc

Install Xcode from the App Store — this step is slow, expect 30-60+ min
Run: sudo xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch
Accept the Xcode license when prompted
Apple Silicon only: run sudo softwareupdate --install-rosetta --agree-to-license

Run flutter doctor in terminal
The full flutter doctor output. Every [✗] line tells you exactly what's missing (missing Android SDK, unaccepted licenses, Xcode not found, etc.) — crop/highlight the red [✗] lines specifically, that's the part worth showing
Common fix: flutter doctor --android-licenses to accept SDK licenses if Android toolchain shows an error
Common fix: if flutter command isn't found after PATH edit, close and reopen the terminal fully (a source in one tab doesn't propagate to others)