arch-atlas
Docs Atlas·Chapter 02 / 06·20 min

One feature, end to end

Trace the cold start

If chapter 01 was the theory, this is the camera following the data. Sixteen frames take you from the user tapping the app icon to the books appearing on screen, naming the exact lines that fire in each file. By the end you'll know which line in `service_locator.dart`, which line in `BlocProvider`, which line in `BooksRepoImpl` does what — and when. The skeleton is the same skeleton you'll reuse on every CA project.

8Sections13Snippets

Boot

Frames 1-3 — App startup

  • The scenario & cast

    What we're tracing

  • Boot — Hive opens, GetIt wires

    Frames 1-3

Mount

Frames 4-5 — Route + Cubit

  • Route mounts the Cubit

    Frames 4-5

Fetch

Frames 6-12 — Through every layer

  • Use case → Repo (boundary where exceptions die)

    Frames 6-7

  • Data sources — cache empty, hit Gutendex

    Frames 8-10

  • JSON → Model → Entity → Cache

    Frames 11-12

Render

Frames 13-16 — States become widgets

  • fold → emit Success → BlocConsumer reacts

    Frames 13-14

  • Bonus — pagination + the debounce flag

    Frames 15-16

Sections

· click any card to expand
Annotate0 strokes

Apple Pencil draws with pressure. Fingers still scroll. Saved per pillar.