Flutter comes bundled with a compatible version of Dart, so in most cases you don’t need to install Dart separately. However, if you do install Dart on its own, make sure Flutter’s version of Dart takes priority in your system PATH, as mismatched versions may cause errors.This guide covers all operating systems (Windows, macOS, Linux, ChromeOS).
1. System Requirements
✅ General
64-bit operating system
Disk space: at least 1.5 GB free (not including IDEs or tools)
Internet connection
✅ Tools
Git → required for Flutter SDK management
Terminal or Shell → Command Prompt / PowerShell (Windows), bash/zsh/fish (Linux/macOS/ChromeOS)
Optional IDEs: Android Studio, VS Code, IntelliJ
2. Get the Flutter SDK
Option A: Download Prebuilt SDK (Recommended)
Go to the Flutter SDK releases page.
Download the latest stable release for your OS:
Windows →
.zip
macOS →
.zip
(Intel or Apple Silicon)Linux / ChromeOS →
.tar.xz
Extract it to a permanent location, e.g.:
Option B: Clone from GitHub
If you want to switch channels or versions easily:
3. Add Flutter to Your PATH
So you can run
flutter
from any terminal:Windows
Search "env" → select Edit environment variables for your account.
Under User variables, find
Path
.
If it exists → append:
If not → create a new
Path
variable with that value.Restart your terminal.
macOS / Linux / ChromeOS
Edit your shell config (
~/.zshrc
,~/.bashrc
, or~/.bash_profile
) and add:
Then reload your shell:
4. Dart SDK Compatibility
⚠️ Important: Flutter already bundles Dart inside:
If you’ve installed Dart separately, ensure Flutter’s Dart comes first in your PATH.
Check paths
Run:
✅ Correct → both from the same directory:
❌ Incorrect → different directories (conflict):
๐ Fix: move Flutter’s
bin
higher in PATH than standalone Dart.
5. Verify Installation
Run:
This checks your setup and reports missing dependencies (e.g., Android SDK, Xcode, Chrome).
Example output:
๐ Follow instructions in the report to resolve issues, then run
flutter doctor
again.
6. Android Setup
To develop for Android:
Install Android Studio
Includes Android SDK, platform tools, and emulator.
Connect a Device
Enable Developer options & USB debugging on your phone.
Connect via USB → run:
Set up Emulator
In Android Studio → AVD Manager → Create Virtual Device
Choose system image (x86/x86_64 recommended)
Enable hardware acceleration (GLES 2.0)
7. iOS/macOS Setup (macOS only)
Install Xcode from the App Store.
Run:
Accept licenses:
8. Web Setup
Enable web support with:
Verify:
You should see Chrome or another browser listed.
9. Create and Run Your First App
✅ Summary
Install Flutter (bundles Dart)
Ensure Flutter’s Dart is first in PATH
Run
flutter doctor
to fix dependenciesSet up platform SDKs (Android, iOS, Web, Desktop)
Create and run apps ๐