Phase 1 · Dart FoundationsModule 2~46 min read

Install Flutter & Build the First App

Install the toolchain, validate it with flutter doctor, launch an emulator or device, and run your first Flutter application.

What you'll learn

Install the toolchain, validate it with flutter doctor, launch an emulator or device, and run your first Flutter application. The lesson turns the APIs into a repeatable engineering workflow instead of a collection of isolated snippets.

By the end of this lesson, you'll be able to:

  • Apply Stable SDK installation in a production-shaped Flutter feature
  • Apply flutter doctor in a production-shaped Flutter feature
  • Apply Editors and extensions in a production-shaped Flutter feature
  • Apply Emulators and devices in a production-shaped Flutter feature

Core mental model

Connect each API to the decision it supports. Flutter code stays maintainable when state, ownership, lifecycle, and platform boundaries are explicit.

ConceptWhat it meansDecision rule
flutter doctorA diagnostic report for the installed toolchainResolve only the sections required by your promised targets
Generated hostsPlatform folders wrap the shared Dart applicationEdit native hosts only for platform configuration or integration
Hot reloadUpdated Dart code is injected while app state is preservedUse restart when initialization or native code changed

Professional workflow

Work in small vertical slices and keep behavior observable from the first iteration.

  1. Define the verified Flutter workspace boundary: user goal, inputs, visible states, ownership, and expected failures.
  2. Build the smallest working vertical slice with typed data and explicit dependencies.
  3. Represent loading, empty, success, and failure behavior where the feature can encounter them.
  4. Verify logic away from the UI, then exercise the rendered behavior at its public boundary.
  5. Inspect lifecycle, accessibility, performance, security, and platform behavior before widening the feature.
  6. Refactor only after behavior is protected by repeatable evidence.

Protect the frame

Keep build methods predictable, move side effects to explicit owners, and measure before introducing caches, isolates, or architectural layers.

Guided Flutter lab

Build a focused verified Flutter workspace slice

These commands establish a reproducible baseline: stable SDK, visible diagnostics, an intentional organization identifier, and an explicit target device.

terminal.txt
flutter channel stable
flutter upgrade
flutter doctor -v
flutter create --org io.mastercoding course_app
cd course_app
flutter devices
flutter run

Production practice

Contract

Define the verified Flutter workspace inputs, outputs, owner, lifecycle, visible states, and platform assumptions before selecting APIs or packages.

Verification

Protect pure rules with unit tests and the rendered public contract with widget or integration evidence; include one unavailable or failure case.

Operations

Keep dependencies replaceable, log actionable context without user secrets, and measure user-visible behavior before optimizing.

Common failure mode

Treating every flutter doctor warning as equally urgent wastes time; ignoring a warning for a platform you promise to ship creates a delayed release blocker.

Independent workshop

Extend the guided lab into a review-ready verified Flutter workspace feature that fits the running course portfolio app.

Your finished workshop must include:

  • Stable SDK installation
  • flutter doctor
  • Editors and extensions
  • Emulators and devices
  • Project structure
  • Automated verification and a short design note

Definition of done

Demonstrate the happy path, an empty or unavailable state, and at least one failure path. Add an automated check and a short note explaining one design decision.

Recap & quick check

Key takeaways

  • flutter doctor: Resolve only the sections required by your promised targets
  • Generated hosts: Edit native hosts only for platform configuration or integration
  • Hot reload: Use restart when initialization or native code changed

Quick check

1. Which rule best applies to flutter doctor?

2. Which rule best applies to Generated hosts?

3. Which rule best applies to Hot reload?

Next: Variables, Types & Operators