Home › Quick Install

🛠️ Install Flutter on Your Computer

⏱️ 30-45 minutes 📊 Beginner — No coding required! 🏷️ Setup, Installation, Tools

🧒 What is Flutter? (Explained Like You're 5!)

📱

Imagine You Want to Build a Toy House...

Pretend you want to build the same toy house for your friends who live in different places — one friend has a phone, another has a computer, and another has a tablet. Normally, you'd need to build three different houses using three different sets of instructions. That's a lot of work!

Flutter is like a magic tool that lets you build your toy house once, and then — POOF! ✨ — it automatically works on phones, computers, and tablets. You write the instructions one time, and Flutter makes it work everywhere. That's why they say "Build for any screen."

🧰

What Tools Do You Need?

To build with Flutter, you need three things on your computer:

📦

1. Flutter SDK

The "magic box" that contains all of Flutter's building blocks. This is the main thing we're installing today!

✏️

2. A Code Editor

A special program where you write your instructions. We'll use Visual Studio Code (VS Code) — it's free and awesome!

🔧

3. Git

A helpful tool that keeps track of changes to your code. Flutter uses it behind the scenes.

🎮

Think of It Like Installing a Video Game

Installing Flutter is just like installing a new game on your computer. You download it, follow some steps, and then you can start playing (or in our case, building apps)!

Don't worry if some words look scary — like "SDK" or "PATH" or "terminal." I'll explain every single thing in plain English. You don't need to be a computer genius. If you can follow a recipe to make a sandwich, you can install Flutter! 🥪

💪
You've got this! Thousands of people just like you have installed Flutter. If you get stuck, there's a whole community ready to help. Plus, I'll walk you through every single click.

🖥️ First: What Kind of Computer Do You Have?

The installation steps are slightly different depending on whether you use Windows, macOS (Apple), or Linux. Click the tab that matches your computer:

Step 1 Install Git for Windows

What is Git? Git is like a magical "save button" for your code. It remembers every change you make, so if you mess up, you can always go back to a working version. Flutter uses Git to download and update itself.

👉 Do this:

  1. Go to the Git website: git-scm.com/download/win ↗
  2. The download should start automatically. If it doesn't, click the link that says "Click here to download manually"
  3. Once downloaded, double-click the file (it's called something like Git-2.xx.x-64-bit.exe)
  4. A window will open — this is the "installer." It's going to ask you many questions. Just keep clicking "Next" — the default answers are perfect!
  5. When you see "Install," click it. Wait for it to finish, then click "Finish."
Check if Git installed correctly
C:\Users\You> git --version
git version 2.47.0.windows.1
# If you see a version number like above,
# Git is installed! 🎉
💡
What if I don't see a version number? Try closing and reopening the Command Prompt, then type the command again. If it still doesn't work, try restarting your computer — sometimes Windows needs a fresh start to recognize new programs.

Step 2 Install Visual Studio Code (VS Code)

What is VS Code? VS Code is like a super-smart notebook where you'll write your Flutter code. It highlights different parts of your code in different colors (so it's easier to read), suggests what to type next, and helps you find mistakes. Think of it as Microsoft Word, but for programmers!

👉 Do this:

  1. Go to the VS Code website: code.visualstudio.com/download ↗
  2. Click the big Windows button to download
  3. Once downloaded, double-click the installer (it's called something like VSCodeUserSetup-x64-1.xx.x.exe)
  4. Click "Next" through the setup screens. When you see "Select Additional Tasks," check these two boxes:
    • ✅ "Add 'Open with Code' action to Windows Explorer"
    • ✅ "Add to PATH"
  5. Click "Install" and wait. When it's done, click "Finish" — VS Code will open!
💡
Why check those two boxes? "Add to PATH" makes it so you can open VS Code by typing code in the terminal (we'll use this later). "Open with Code" lets you right-click any folder and open it directly in VS Code. Super handy!

Step 3 Install Flutter Using VS Code (The Magic Part!)

This is the exciting part! We're going to install Flutter from inside VS Code. It's like ordering pizza from an app — you don't need to go anywhere, just click a few buttons.

👉 Do this step-by-step:

  1. Open VS Code (if it's not already open from Step 2)
  2. Add the Flutter extension:
    • On the left side of VS Code, there's a sidebar with icons. Click the one that looks like four squares (it's called "Extensions")
    • In the search box that appears, type "Flutter"
    • Look for the one that says "Flutter" by Dart Code — it usually has a blue checkmark
    • Click the blue "Install" button
    • Wait for it to install. This also installs the Dart extension automatically!
  3. Open the Command Palette:
    • Press Ctrl + Shift + P on your keyboard (hold Ctrl, hold Shift, then press P)
    • A box will appear at the top of VS Code — this is the "Command Palette" (it's like a search box for commands)
  4. Create a new Flutter project:
    • In the Command Palette, type: "flutter"
    • Select "Flutter: New Project" from the list
  5. Download Flutter SDK:
    • VS Code will ask: "Do you want to locate the Flutter SDK?"
    • Click "Download SDK"
    • Choose where to save Flutter on your computer. I recommend saving it in a folder called C:\flutter or in your Documents folder
    • Click "Clone Flutter"
    • A notification will pop up saying "Downloading the Flutter SDK. This may take a few minutes."
    • ⏳ Wait patiently! This downloads about 1-2 GB of files. It might take 5-15 minutes depending on your internet speed. Grab a snack! 🍿
  6. Add Flutter to PATH:
    • Once the download finishes, VS Code will ask if you want to "Add SDK to PATH"
    • Click "Add SDK to PATH"
    • You'll see a notification: "The Flutter SDK was added to your PATH"
⚠️
What is "PATH" and why does it matter? "PATH" is like a list of places your computer looks for programs. When you type "flutter" in the terminal, your computer checks the PATH list to find the Flutter program. Adding Flutter to PATH is like telling your computer: "Hey, Flutter lives in this folder — look here when I ask for it!"
💡
Important last step! After adding Flutter to PATH:
  • Close ALL terminal windows you have open
  • Restart VS Code (close it completely and open it again)
This makes sure your computer "sees" the new PATH. It's like refreshing a webpage to see the latest content!

Step 4 Check That Everything is Working

Let's make sure Flutter is installed correctly. We'll use the terminal — a text-based way to talk to your computer.

👉 Open the terminal in VS Code:

  1. In VS Code, go to the top menu: Terminal → New Terminal
  2. A panel will open at the bottom of VS Code. This is your terminal!
Terminal — Check Flutter Installation
C:\Users\You> flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.44.0, ...)
[✓] Windows Version (...)
[✓] Android toolchain - develop for Android devices
[✓] Chrome - develop for the web
[✓] Visual Studio - develop Windows apps
[✓] Android Studio (version ...)
[✓] VS Code (version ...)
[✓] Connected device (3 available)

• No issues found!
# If you see green checkmarks [✓],
# Flutter is ready! 🚀
🎉
You did it! If you see green checkmarks like above, Flutter is installed and working perfectly. The flutter doctor command is like a health checkup for Flutter — it tells you if everything is in good shape.
🔍
See any red X marks [✗]? Don't panic! flutter doctor will tell you exactly what's missing and how to fix it. Read the messages carefully — they're usually very clear about what you need to do. Common fixes include installing Android Studio or accepting Android licenses.

Step 1 Install Git (Using Xcode Command Line Tools)

What is Git? Git is like a magical "save button" for your code. It remembers every change you make, so if you mess up, you can always go back. Flutter uses Git to download and update itself.

On macOS, we install Git through Xcode Command Line Tools — a set of essential tools Apple provides for developers.

👉 Do this:

  1. Open the Terminal app on your Mac. You can find it by:
    • Pressing Cmd + Space (this opens Spotlight search)
    • Typing "Terminal"
    • Pressing Enter
  2. In the Terminal window, type this command exactly as shown:
Terminal — Install Xcode Command Line Tools
you@Mac ~ % xcode-select --install
# A dialog box will appear asking if you want to install the tools.
  1. A popup window will appear on your screen. Click "Install"
  2. Click "Agree" to the license agreement
  3. Wait for the download and installation to finish (it might take 5-10 minutes)
  4. When it's done, click "Done"
💡
What if I already have Xcode installed? If you've ever installed Xcode from the App Store, you might already have Git! Try typing git --version in Terminal. If you see a version number, you can skip this step.

Step 2 Install Visual Studio Code (VS Code)

What is VS Code? VS Code is like a super-smart notebook where you'll write your Flutter code. It highlights different parts of your code in different colors, suggests what to type next, and helps you find mistakes.

👉 Do this:

  1. Go to the VS Code website: code.visualstudio.com/download ↗
  2. Click the big Mac button to download
  3. Once downloaded, you'll have a .zip file. Double-click it to unzip
  4. Drag the "Visual Studio Code" icon into your "Applications" folder
  5. Open VS Code from your Applications folder (or search for it with Spotlight: Cmd + Space)

Step 3 Install Flutter Using VS Code

This is the exciting part! We'll install Flutter from inside VS Code.

👉 Do this step-by-step:

  1. Open VS Code
  2. Add the Flutter extension:
    • Click the Extensions icon on the left sidebar (it looks like four squares)
    • Search for "Flutter"
    • Find "Flutter" by Dart Code and click "Install"
  3. Open Command Palette: Press Cmd + Shift + P
  4. Type "flutter" and select "Flutter: New Project"
  5. When asked to locate Flutter SDK, click "Download SDK"
  6. Choose a location (I recommend your Documents folder or your home folder)
  7. Click "Clone Flutter" and wait for the download to finish (5-15 minutes)
  8. When prompted, click "Add SDK to PATH"

Step 4 Verify Your Installation

👉 Do this:

  1. Close and reopen all Terminal windows
  2. Restart VS Code
  3. Open Terminal in VS Code: Terminal → New Terminal
  4. Type the verification command:
Terminal — Verify Flutter
you@Mac ~ % flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.44.0, on macOS ...)
[✓] Xcode - develop for iOS and macOS
[✓] Chrome - develop for the web
[✓] Android Studio
[✓] VS Code
[✓] Connected device

• No issues found!
🎉
All green checkmarks! Your Mac is now a Flutter development machine. 🚀

Step 1 Install Required Packages

What are these packages? These are small programs that Flutter needs to work properly. Think of them as ingredients for a recipe — you need all of them before you can start cooking!

We need: curl, git, unzip, xz-utils, zip, and libglu1-mesa.

👉 Do this:

  1. Open your Terminal (press Ctrl + Alt + T on most Linux systems)
  2. Type these two commands, pressing Enter after each one:
Terminal — Install Packages
you@linux:~$ sudo apt-get update -y && sudo apt-get upgrade -y
# This updates your package list. You might need to enter your password.
you@linux:~$ sudo apt-get install -y curl git unzip xz-utils zip libglu1-mesa
# This installs all the packages Flutter needs.
⚠️
What does "sudo" mean? "sudo" stands for "superuser do" — it's like asking your computer for permission to install things. You'll need to type your password (the same one you use to log in). When you type your password, you won't see anything appear on screen — that's normal! It's a security feature. Just type your password and press Enter.

Step 2 Install Visual Studio Code

On Linux, you can install VS Code through your package manager or download it directly.

👉 Option A (Easier): Use Snap

Terminal — Install VS Code via Snap
you@linux:~$ sudo snap install code --classic

👉 Option B: Download from website

  1. Go to: code.visualstudio.com/download ↗
  2. Download the .deb (Debian/Ubuntu) or .rpm (Fedora/Red Hat) file
  3. Double-click the downloaded file to install

Step 3 Install Flutter Using VS Code

Same process as Windows/macOS!

  1. Open VS Code
  2. Install the Flutter extension (Extensions icon → search "Flutter" → Install)
  3. Press Ctrl + Shift + P → type "flutter" → select "Flutter: New Project"
  4. Click "Download SDK"
  5. Choose a location (I recommend ~/flutter or ~/Documents/flutter)
  6. Click "Clone Flutter" and wait for the download
  7. When prompted, click "Add SDK to PATH"

Step 4 Verify Your Installation

👉 Close all terminal windows, restart VS Code, then:

Terminal — Verify Flutter
you@linux:~$ flutter doctor
Doctor summary (to see all details, run flutter doctor -v):
[✓] Flutter (Channel stable, 3.44.0, on Linux ...)
[✓] Chrome - develop for the web
[✓] VS Code

• No issues found!
🎉
Flutter is installed on Linux! You're ready to start building apps. 🐧

🔧 Uh Oh! Something Went Wrong?

Don't worry! Here are solutions to the most common problems people face:

❌ "flutter command not found"

This means your computer doesn't know where Flutter is. Make sure you:

  • Clicked "Add SDK to PATH" during installation
  • Closed and reopened ALL terminal windows
  • Restarted VS Code completely
  • On macOS/Linux, try running: source ~/.bashrc or source ~/.zshrc

❌ Download gets stuck

If the Flutter download seems frozen:

  • Click "Cancel" and try again
  • Check your internet connection
  • Try downloading during a time when your internet is faster
  • As a last resort, download Flutter manually from flutter.dev

❌ VS Code can't find Flutter

If VS Code keeps asking where Flutter is:

  • Make sure the Flutter extension is installed
  • Try restarting VS Code
  • Go to VS Code settings (Ctrl+,) and search "flutter sdk path" — you can manually set the path there

❓ Other problems?

Check the official troubleshooting guide:

Flutter Installation Troubleshooting ↗

🚀 What's Next?

Now that Flutter is installed, you're ready to create your first Flutter app!

In the next lesson, you'll learn:

  • How to create a brand new Flutter project
  • What all the files and folders mean
  • How to run your app and see it on screen
  • How to make your first change to the app
Next Lesson: Create Your First Flutter App →
🎉

Installation Complete!

You've successfully set up Flutter on your computer. That was the hardest part — everything from here gets more fun because you'll actually be building things!

Click the button above to track your progress!