Phase 1 · Dart FoundationsModule 5~44 min read

Collections & Transformations

Work fluently with typed lists, sets, maps, lazy iterables, collection control flow, and immutable transformations.

What you'll learn

Work fluently with typed lists, sets, maps, lazy iterables, collection control flow, and immutable transformations. 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 List, Set & Map in a production-shaped Flutter feature
  • Apply Generic collections in a production-shaped Flutter feature
  • Apply Spread and collection if/for in a production-shaped Flutter feature
  • Apply Iterable pipelines 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
IterableA potentially lazy sequence of valuesKeep transformations lazy until a concrete collection is required
SetAn unordered collection of unique valuesUse when uniqueness or fast membership is the invariant
MapA key-to-value lookup structureChoose stable keys that model identity rather than list position

Professional workflow

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

  1. Define the immutable course collection pipeline 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 immutable course collection pipeline slice

This compact example keeps the important ownership and data-flow decisions visible so the behavior is easy to extend and test.

lib/catalog.dart
record Course(String id, String title, Set<String> tags);

List<String> titlesForTag(List<Course> courses, String tag) {
  return courses
      .where((course) => course.tags.contains(tag))
      .map((course) => course.title)
      .toList(growable: false)
    ..sort();
}

Production practice

Contract

Define the immutable course collection pipeline 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

Spread syntax and List.from make shallow copies; nested mutable objects are still shared and can change behind an apparently new collection.

Independent workshop

Extend the guided lab into a review-ready immutable course collection pipeline feature that fits the running course portfolio app.

Your finished workshop must include:

  • List, Set & Map
  • Generic collections
  • Spread and collection if/for
  • Iterable pipelines
  • Sorting and lookup
  • 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

  • Iterable: Keep transformations lazy until a concrete collection is required
  • Set: Use when uniqueness or fast membership is the invariant
  • Map: Choose stable keys that model identity rather than list position

Quick check

1. Which rule best applies to Iterable?

2. Which rule best applies to Set?

3. Which rule best applies to Map?

Next: Functions, Closures & Functional Techniques