Files
doormile_customer_app/design/screens
Thiru-tenext 8427824951 A launch that opens in brand, and a sheet that stops resizing
── The splash, in three beats ──

Crimson edge to edge with the truck running across it in white; the invert;
then the mark.

The red starts before Flutter does. Four surfaces painted white before any
Dart runs — launch_background at both API levels, windowSplashScreenBackground
on Android 12+ in light and dark, and the iOS launch storyboard — and leaving
any one of them white makes the launch a white flash followed by a red one.
That flash is the only part of a launch a customer consciously notices.

The invert is one gesture rather than a fade. A white truck on a background
turning white is an invisible truck, so the ground lightens as the truck
darkens, off one controller, and the screen turns itself inside out with the
truck still on it. Fading it would have left the screen empty for the moment
before the mark.

The truck's colour is no longer its own: it is painted through srcIn, so the
file's palette is discarded and only alpha survives. A replacement Lottie now
needs no preparation, and tool/lottie_brand.py is off this path.

`splash.json` is a seamless 3.9s loop — frame 0 is frame 60, the truck never
arrives or departs — so there is no completion to hand over on. _truckBeat is
a decision about how long a launch may hold somebody, not a property of the
file. The comment claiming six seconds was wrong on both counts.

── Three things the splash was getting wrong quietly ──

It showed the wrong logo: doormile-icon.png, the previous mark, to a customer
who had just tapped the new one. tool/icons.py now cuts doormile-mark.png from
the same master alpha as the launcher icon, so they cannot drift again.

The fallback loader was invisible on red. _RoadLoader painted in DmColors.brand
on what used to be a white screen; on crimson that is crimson on crimson, and
it drew nothing at all on exactly the devices that had fallen back to it.

The mark appeared and left in the same frame — _minimum was the sum of the
beats exactly, so the clock ran out as the entrance finished. Hence _markHold.

── The truck was not in the middle ──

Not a layout bug: both beats sit in a Center and always did. The artwork is
drawn low and to the right inside its own 500x500 composition, so a centred
widget rendered an off-centre picture — 30pt right, 36pt down.

splash_centring_test.dart renders a frame at phone size and density, finds the
ink and fails if either beat drifts. It is the only form of test that could
have caught this, and the one that will catch it again when the Lottie is
replaced, which is when the correction goes stale. Two things it taught:
one enormous pump does not let the splash's async start-up chain advance, and
capturing at pixelRatio 1 rasterizes the speed lines too faintly to detect,
which truncates the bounding box and moves the measured centre by 12pt.

── The destination sheet stops resizing ──

Tapping ONE TOUCH opened a tall sheet that snapped shorter a few frames later.
DmAsyncList renders four skeleton rows while it loads — 302pt — and the states
that replace them are nearer 200; the sheet was Flexible, so it was as tall as
whichever state its content happened to be in, and the modal is still
animating up while that swap happens.

The list now lives in a box of one height. That also removes a second resize:
the sheet grew from 48% of the screen to 74% when a state was picked. Both
steps now measure 64% and it never changes size again.

And DmAsyncList takes initialItems, fed by AppState.cachedCities: FutureBuilder
reports `waiting` on its first build even for an already-complete future, so a
warm cache still flashed a skeleton over data it already had.

Three skeleton rows here rather than four — sheet_stability_test caught that
302pt overflows the smallest box the clamp can produce.
2026-09-28 12:54:03 +05:30
..

Screens

Every screen in the app, at 390×844 @3x, with the real fonts.

These are the golden files from test/snapshots/, copied here under readable names so the set can be browsed, shared or dropped into a deck without anyone having to know what a golden is. test/snapshots/ is the source of truth — this folder is a copy, and a stale copy is worse than none, so refresh it whenever the design moves:

flutter test test/design_snapshot_test.dart --run-skipped --update-goldens
tool/screens.sh

They are rendered by the test harness rather than captured from a handset, so they are identical on any machine and need no device attached. Two consequences worth knowing: map tiles are blank, because the harness has no network and CARTO is fetched live; and the data is DevDoormileApi's, so the names, addresses and references are invented.

File Screen
00-splash-truck.png Splash · first beat What the app does, in white on the brand crimson the launcher icon opens from.
00b-splash-invert.png Splash · second beat The invert, caught halfway: the ground lightening as the truck darkens, both on one curve.
00c-splash-mark.png Splash · third beat Whose app it is. The same mark the launcher icon is cut from.
01-sign-in.png Sign in One question, one field, one button.
02-sign-up.png Create account The same shell, three fields.
03-verify-code.png Verify the code One field behind four boxes that only draw.
04-home.png Home Welcome, the pickup address, BOOK, and the live booking.
05-pickup-search.png Collect from Changing the pickup address from the Home header.
06-orders-active.png Orders · Active State, date, route, packages, reference.
07-orders-completed.png Orders · Completed Delivered orders and what they cost.
08-account.png Account Grouped rows, and the build this handset is running.
09-tracking.png Live tracking The live card, the map, the Miler, the journey rail.
10-cancel-pickup.png Cancel this pickup The one destructive action, behind a reason.
11-destination-states.png Where is it going? · states Step one, with the state marks.
12-destination-districts.png Where is it going? · districts Step two. Multi-select where the server allows it.
13-pickup-window.png Pickup window The times, and nothing else.
14-send-a-parcel.png Send a parcel The route, the packages, the two commitments.
15-pickup-map.png Pickup point The map editor, and who the Miler asks for.
16-pickup-booked.png Pickup booked White tick on green. The reference and the live search.
17-receipt.png Order details What was collected, weighed, photographed and paid.

Not here yet

First-run Home — the sphere's caption and the "How it works" rail only appear for a customer with no orders, and the dev backend seeds three. It needs a flag on DevFlags to capture, which is not worth adding for a picture.