flutter-setup

Flutter Environment Setup & Troubleshooting Guide

Goal

Establish a reliable, optimized Flutter development environment across Linux, macOS, and Windows platforms. This guide covers initial SDK installation, PATH configuration, IDE setup, and comprehensive troubleshooting for common setup issues, dependency conflicts, and tooling misconfigurations.

Prerequisites Checklist

Before starting Flutter installation, verify:

• Disk Space: Minimum 2.8 GB for SDK, plus additional space for IDEs and Android SDK
• Network Access: Stable internet connection for downloading SDK and dependencies
• Administrative Access: Ability to modify system PATH and install software
• Git Installed: Required for Flutter SDK management and updates

---

🚀 Installation Process

Step 1: Download and Extract Flutter SDK

1. Download the latest stable Flutter SDK from flutter.dev for your platform
2. Extract to a permanent location (avoid temporary directories)
3. Important: Choose paths without spaces or special characters

Recommended Installation Paths:

• Linux/macOS: ~/development/flutter or /opt/flutter
• Windows: C:\develop\flutter (NEVER use C:\Program Files\)

Step 2: Configure PATH Environment Variable

Linux/macOS PATH Configuration

Add Flutter to your shell configuration file:

For Bash (~/.bashrc or ~/.bash_profile):

export PATH="$PATH:$HOME/development/flutter/bin"
export PATH="$PATH:$HOME/development/flutter/.pub-cache/bin"

For Zsh (~/.zshrc):

export PATH="$PATH:$HOME/development/flutter/bin"
export PATH="$PATH:$HOME/development/flutter/.pub-cache/bin"

For Fish (~/.config/fish/config.fish):

set -gx PATH $PATH $HOME/development/flutter/bin
set -gx PATH $PATH $HOME/development/flutter/.pub-cache/bin

Apply changes immediately:

source ~/.bashrc  # or ~/.zshrc or ~/.bash_profile

Windows PATH Configuration

Method 1: PowerShell (Recommended)

$flutterPath = "C:\develop\flutter\bin"
$currentPath = [Environment]::GetEnvironmentVariable("Path", [EnvironmentVariableTarget]::User)
if ($currentPath -notmatch [regex]::Escape($flutterPath)) {
    [Environment]::SetEnvironmentVariable("Path", "$currentPath;$flutterPath", [EnvironmentVariableTarget]::User)
}